itaywol/adeptability / internal/defaultskills/assets/managing-library
managing-library
VerifiedMaintain an adept skill library (repo from `adept init --as-library`): published vs private skills, add --publish, syncing dev helpers to your harness. Apply in a library-layout project or when `adept skill list` shows a published/private source.
Managing an adept library
A library is a repo created with adept init --as-library. It exists to publish skills
to other repos. It has two skill locations — keep them straight:
| location | source in adept skill list | published to consumers? | purpose |
|---|---|---|---|
skills/<id>/ (repo root) | published | yes | the library's product |
.adeptability/skills/<id>/ | private | no | dev-only helpers, rendered to your harness |
config.json carries "layout": "library". Consumers add the repo with
adept library add <name> --from <git-url> and only ever see the published skills/.
Adding skills
In a library, adept skill add defaults to private (it's the safe default — nothing is
published by accident). Use --publish for skills that ship to consumers:
adept skill add my-helper # → .adeptability/skills/my-helper/ (private, dev-only)
adept skill add pr-review --publish # → skills/pr-review/ (published)
adept skill list # SOURCE column shows published | private | library:<name>
edit and remove take a bare <id> and find it in either location (published wins on a
name clash):
adept skill edit pr-review
adept skill remove my-helper
Rendering dev helpers to your own harness
Private skills render to your enabled harnesses so they assist you while you author the library, without shipping:
adept harness add claude-code # once
adept sync # renders published + private → .claude/skills/, …
echo ".claude/" >> .gitignore # rendered output is not source
adept init --as-library seeds this skill and the authoring helpers (using-adept,
authoring-adept-skills) straight into .adeptability/skills/ for you.
Publishing
Commit and push. Only skills/ (published) reaches consumers; .adeptability/skills/ and the
gitignored .claude/ stay local.
git add skills .adeptability && git commit -m "add <skill>" && git push
Rules of thumb:
- Edit canonical (
skills/<id>/SKILL.mdor.adeptability/skills/<id>/SKILL.md), thenadept sync. Never hand-edit rendered harness files — runadept sync-fromto adopt those. - Run
adept status/adept diffbefore and after a sync to see what changed. adept --helpandadept skill --helpare the source of truth for flags.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |