manage-skills
Creates, updates, and reviews skill packages and their references in applicable contracts. Use when the operator wants a new skill, when a skill's workflow, name, location, or files change, or to find outdated skills and references.
- License 许可
- MIT
- 所属仓库
- MYRS-ai/aiOS
- 最近更新
- 2026-10-26
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- manage-skills
- description
- Creates, updates, and reviews skill packages and their references in applicable contracts. Use when the operator wants a new skill, when a skill's workflow, name, location, or files change, or to find outdated skills and references.
02 资源文件 2
- 参考文档agents/openai.yaml43 B
- 资产文件assets/skill-template.md392 B
03 SKILL.md 正文
Manage skills
Builds and maintains skill packages that follow the aiOS skill structure, so agents use them reliably in Claude Code and Codex.
When to use
- The operator wants a skill for a task that repeats.
- A skill's workflow, scripts, references, or assets change.
- A skill is renamed, moved, or retired, or its invocation conditions change.
- The operator states a preference for how a skill should work.
- The operator wants skills checked for outdated or poorly structured content.
Workflow
Before you begin:
- Read the skill definition first. It defines the package structure, front matter, sections, and writing style.
- Follow Maintaining vocabulary before introducing or changing concepts in a skill.
Follow Create a skill, Update a skill, or Review skills.
Create a skill
-
Confirm that a skill is the right tool, using the definition's "When to create a skill."
-
Ask the operator what the skill should achieve, when it should run, and what it should report. Walk through one real instance of the task together.
-
Choose the location and name using the definition's "Where skills live." Start Contract and reference checks before writing.
-
Draft the workflow as numbered steps. Put supporting files where they belong:
- Repeatable mechanics in
scripts/ - Detail needed only sometimes in
references/ - Templates, examples, and other supporting material in
assets/ - Display metadata in
agents/. For Codex, setinterface.display_nameinagents/openai.yaml
- Repeatable mechanics in
-
Create the package. Start its
SKILL.mdfrom assets/skill-template.md. -
Write the description last: what the skill does, then "Use when" and the situations from step 2.
-
Complete Contract and reference checks for the new skill.
Update a skill
- Read
SKILL.mdand list the package's files. - Start Contract and reference checks. Record existing names and paths before a rename or move.
- Read affected files, their dependencies, and their uses. Expand your reading until you understand the change's impact.
- Make the change. Keep
SKILL.md, scripts, references, and assets consistent with each other. - Update the description if the situations it covers changed.
- Run any changed script to confirm it works.
- Complete Contract and reference checks against the resulting package.
Review skills
- Find every
SKILL.mdin the folder tree the operator names. - Read each whole package and compare it with the definition. Look for missing sections, files that
SKILL.mdnames but the package lacks, files nothing uses, and aSKILL.mdover about 100 lines. Change nothing yet. - Run Contract and reference checks for each skill. Record differences without editing.
- Propose a fix for each difference. Apply the fixes the operator confirms.
Contract and reference checks
These checks apply to all three workflows. Read contracts before editing; verify references after changes. During reviews, report proposed corrections without editing.
- Read applicable
AGENTS.mdfiles where the skill lives and is used, including ancestors outside the repository. - Check where agents should discover the skill. Add missing guidance without repeating inherited instructions.
- For renames, moves, retirements, or changed invocation conditions, search the skill's names and paths across the task's scope.
- Correct maintained source references. Use
aios-core:manage-agents-mdfor contract edits. - Repeat the search and verify names, paths, and invocation conditions. Explain any old references that must remain.
The stop hook checks the front matter of every changed SKILL.md when the turn ends.
Report
- Lead with the outcome or most consequential finding and its practical effect.
- Give only the context needed to understand, use, or assess the result. Include useful links.
- State any decision or action still needed, with a specific next step.
For reviews, prioritize findings by impact and recommend fixes. If no issues were found, say so and name what was checked.
04 同仓库更多 Skills
visualize
Explains a concept, system, or process with a diagram or other visual.
unslop
Removes AI writing patterns and improves prose clarity.
explain
Explains a concept for a stated audience, using concrete examples.
clarify
Rewrites prose so it is clear, concise, and plain. Applies the writing standard.
research-to-video
Turns research findings into a short explainer video.
refine
Improves a design against stated quality criteria and the design standard.