skill
Adom Wiki
Public Made by Adomby adom
How the Adom Wiki (wiki.adom.inc) works and how to drive it with the adom-wiki CLI: the two storage layers (git page repo vs package registry), hosting source by pushing files (not a tarball), making packages, cutting per-platform releases, and the three-tier skill layout (user skills ship, dev-skills/ and publish-skills/ stay source-only). adom-wiki is the current tool; adompkg is deprecated. Read this first before publishing or installing.
Skill discovery fleet audit: delivery gaps + undiscoverable layouts (lint shipped)
Tracking issue for the skill-discovery fleet audit (2026-08-03) and the wiki's share of the fixes. Context: Claude Code registers skills from exactly one directory level under ~/.claude/skills/, and the adom-wiki CLI auto-delivers bundled skills for COMPONENT packages only.
Audit results (all 307 released packages, latest tarball of each)
- 10 skill-type packages install nothing. The skill is the product, and neither the CLI nor their install.sh delivers it: adom/kicad, adom/fusion, adom/altium, adom/eda, adom/agent-ground-rules, adom/wiki-notes-via-discussions, adom/adom-statusline, adom/hardware-pipeline, adom/agent-browser-isolation, adrianwowk/test.
- 45 apps ship SKILL.md files with no delivery path (verified live: adom/hero-studio is installed on this container, its skill dir does not exist). A few self-deliver via their own binary (adom-tsci) and are fine.
- 2 packages have undiscoverable deep nesting: adom/chip-fetcher and adom/adom-chip-fetcher (duplicate slugs of the same content), whose
skills/sites/<site>/SKILL.mdfiles install as a top-level folder namedsiteswith no root skill: six dead sub-skills each plus a squatted generic name. adom/adom-cli had this pattern and was fixed today (4.1.0, dual-mode layout). - Hygiene: adom-shotlog's old tarball leaked dev-skills/ and publish-skills/ (the auto-exclusion now prevents this; next publish cleans it); adom-chipsmith and adom-workspace-control ship vendored SKILL.md files that never install.
- Everything else is clean: ~100 packages with correctly-delivered skills, 139 with none.
Fix plan and ownership
- CLI (adom/adom-wiki-cli#22): extend skill delivery to all package types, support the dual-mode layout (root dispatcher + .claude-plugin manifest + nested subs), and extend the upgrade backfill so the fleet self-heals.
- Wiki (this issue): publish-time lint, shipped with this issue. Three hints on the publish response:
SKILLS_NOT_DELIVERED(warning: shipped skills no installer places, strongest wording for skill-type packages),NESTED_SKILLS_UNDISCOVERABLE(warning: SKILL.md deeper than skills// without a plugin manifest, teaching both working shapes),SKILL_MD_UNPLACED(info: stray SKILL.md that ships but never installs). Warnings, never blocks: install.sh analysis is textual and some apps deliver via their own binary. The SKILLS_NOT_DELIVERED warning retires once CLI universal delivery is the fleet norm. - chip-fetcher twins: restructure to a working layout and consolidate the duplicate slug (separate follow-up, owner adom).
- The affected skill-type and app packages become correct on their next publish once the CLI ships universal delivery; no mass republish needed.