openskills-skill-authoring

OpenSkills Skill Authoring

Use this skill when creating or updating skills under examples/skills or any OpenSkills-compatible skill directory.

Authoring Standard

Each skill directory should include:

• SKILL.md (required)
• optional scripts/, references/, assets/

SKILL.md Requirements

• YAML frontmatter with:
  • name
  • description
• Body with concise instructions and practical execution flow.
• Description must include both:
  • what the skill does
  • when to activate it

Writing Guidance

1. Keep core instructions short; move details to references/.
2. Prefer deterministic scripts for fragile or repetitive steps.
3. Include explicit input/output expectations.
4. Avoid vague names and ambiguous activation phrases.

Validation Flow

1. Ensure directory name matches skill name semantics.
2. Verify skill discovery and activation behavior in runtime or example agent.
3. If scripts are present, verify paths and execution assumptions.

Output Format

• Skill metadata quality review
• Instruction clarity review
• Activation trigger quality review
• Suggested revisions