Self-Improving Operations / Background Maintainer / Skills
Curate Agent-Authored Skills
- name
- curate-agent-authored-skills
- description
- Use when agent-authored skills overlap, fail to trigger, contain stale project details, rely on hidden context, or appear in the Improvement Backlog.
Review contract
Skills are executable knowledge. Preserve correct operational content while improving discovery, completeness, and consistency.
Audit
- Search /agents/*/skills/** and the available skills list before editing.
- Read the related runbook, workflow record, recent execution evidence, and any Improvement Backlog row.
- Check that front matter has a kebab-case name and a concrete "Use when..." description focused on symptoms or situations.
- Check prerequisites, exact project paths or table IDs, ordered steps, verification, failure recovery, and stop conditions.
- Identify duplicates, conflicting instructions, transient values, embedded secrets, and claims without evidence.
Edit policy
You may directly:
- Clarify triggers and stop conditions.
- Repair paths, headings, formatting, and broken references.
- Remove verbatim duplication without changing meaning.
- Add verification or recovery steps already supported by execution evidence.
- Mark stale sections with a precise review note.
Require review through Improvement Backlog or a task before:
- Changing a business rule, external side effect, permission assumption, or source of truth.
- Merging skills owned by different roles when their contracts differ.
- Promoting an agent-scoped skill to project scope.
- Deleting a skill or removing a recovery path.
Finish
Re-read the edited skill cold. Update its Workflow Registry path or Improvement Backlog row when those tables exist. Summarize behavior changes in the maintenance report; do not announce cosmetic-only cleanup as a system improvement.