← ClaudeAtlas

maintain-skillslisted

Meta-skill for keeping a skill library correct as the codebase evolves — both the shared adora-skills plugin and a project's own .claude/skills/. Use when the user asks to update, refresh, audit, or re-sync skills, says a skill taught something wrong or is out of date, after a big refactor / rename / module move, after CONTEXT.md or an ADR changes, when adding a new domain that needs a skill, or when deciding whether to update an existing skill, write a new one, or delete one.
ltatarev/skills · ★ 0 · AI & Automation · score 65
Install: claude install-skill ltatarev/skills
# Maintain Skills Keep every skill grounded in the code it describes. The standard: **a skill that cites a dead path, dead symbol, or stale command is worse than no skill** — it makes a cheap session confidently wrong. ## Which library are you maintaining? Work out the target before editing anything — they have different rules. | Target | Lives in | Rule | | --- | --- | --- | | **Shared skills** (this plugin) | the `adora-skills` repo, `skills/<name>/SKILL.md` | Must stay **project-agnostic**. No repo-specific paths, baselines, bundle ids, or module names. Teach Claude to *read* the specifics from the repo it is in. | | **Project skills** | `<project>/.claude/skills/` | May be as concrete as you like — cite real paths, real symbols, real baselines. Concreteness is the point. | | **Third-party skills** | other installed plugins' `skills/` | Read-only. Never edit; if one is wrong, note it and work around it. | Plugin skills are installed as a read-only bundle. To change one, edit it in the `adora-skills` repo, push, and run `/plugin marketplace update adora-skills`. Editing the installed copy does nothing durable. **The promotion test.** A project skill earns promotion into the shared plugin only when it is useful in a *second* project without rewriting its body. If generalizing it would strip out the specifics that make it good, it belongs in the project, not the plugin. ## The grounding standard Every skill must satisfy: 1. Every file path it cites exists (in the rep