skill-auto-update
Skill Auto Update
Use this skill to keep project skills aligned with what feedback keeps teaching.
Activation
This skill is most effective when the workspace AGENTS.md tells the AI to use it on every turn. Add a short rule such as: Use $skill-auto-update on every turn to distill durable feedback into the narrowest existing skill.
Treat routine use as a silent background check. Do not announce that you are using this skill unless it produces a user-relevant skill edit or the user explicitly asks about it.
Run this loop
- Scan the current turn for durable feedback signals such as user corrections, review comments, comments on issues or pull requests, repeated instructions, and explicit "do this / avoid this" guidance.
- Ignore one-off facts, task-local preferences, and literal examples that do not imply a reusable rule.
- Rewrite the signal as a principle: capture the idea, not the anecdote; state the invariant in one short sentence; prefer imperative wording such as
Prefer,Keep,Move, orAvoid. - Translate taste or persona goals into concrete engineering rules; prefer
Keep functions small and cohesiveovercode like Uncle Bob. - Update the narrowest existing skill that owns the rule: search for the same idea first, tighten an existing rule when it already exists, and create a new skill only when no current skill can contain the lesson cleanly.
- When a new rule subsumes examples or sibling rules, delete or compress the older text instead of keeping both.
- If the same rule is missed again, increase its score instead of adding another bullet.
- If no durable lesson exists, make no skill edit and do not mention the check.
Editing standard
- Keep skill text concise and imperative.
- Prefer strengthening an existing rule over adding a sibling rule that says the same thing differently.
- Prefer general rules over examples; if an example is necessary, keep one generic example only.
- When a rule, example, and score guidance overlap, keep the rule and only the minimum scoring detail needed: use no score for a fresh rule, start at
[score: 2]for the second clear miss, increment to a maximum of5, and never raise score for a mere style preference. - Avoid historical commentary, changelogs, and case-specific prose.
More from buhond/skills
code-review
Spin up a dedicated reviewer agent to run a strict quality review with a numeric score and pass/fail gate. Use when a user asks for a review, code review, feedback on code quality, or wants unnecessary abstractions removed.
8linear-ticket-pr
Create a Linear issue for the current local change set, place it under the best matching active project, then create the corresponding branch and draft PR named from the Linear issue key. Use when the user wants to turn work that is not on `origin/main` into a tracked Linear ticket plus a GitHub-ready branch and PR, especially when the title should start with the issue key such as `GENG-1234 - Fix something`.
2