skill-creator

name	skill-creator
description	Guide for creating a new workspace skill in the Codex-style SKILL.md format.
metadata	{"short-description":"Create or refine reusable skills for this workspace."}

Skill Creator

This built-in skill is adapted for evidence-rag-agent from the open-source openai/skills repository.

When To Use

• Use this skill when the user wants to create a new reusable skill.
• Use it when an existing workflow keeps repeating and should become a skill.
• Use it when a local skill needs better structure, triggers, or output expectations.

Workflow

1. Clarify the skill's trigger in one sentence.
2. Decide the smallest folder name that matches the behavior.
3. Run /skill create <name> to scaffold the skill in .agents/skills/<name>/.
4. Edit SKILL.md so it explains when to use the skill, how to execute it, and what good output looks like.
5. Update agents/openai.yaml if the display name or summary should be clearer.
6. If helpful, add references/, scripts/, or assets/ next to SKILL.md.

Authoring Rules

• Keep the trigger explicit. A teammate should know exactly when the skill should fire.
• Favor concrete steps over general advice.
• Keep references small and task-specific.
• If the skill depends on tools or scripts, say that plainly in the workflow.
• If the user wants a Codex-like skill, prefer the .agents/skills/<name>/SKILL.md layout.

Deliverables

• A SKILL.md file with frontmatter and clear usage guidance.
• An agents/openai.yaml metadata file.
• Optional supporting files only when they materially help execution.