OpenSkills Skill Authoring

SkillDev tools

Create and refine OpenSkills-compatible skills (SKILL.md + optional resources) with strong metadata, clear activation triggers, and reliable execution guidance.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the OpenSkills Skill Authoring skill

What this skill tells your AI

The instructions your AI receives, as published by geeksfino/openskills in .cursor/skills/openskills-skill-authoring/SKILL.md and read by ahel’s review.

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

Signals

GitHub stars
71
Forks
13
Last commit
Aug 2026
Advanced
Catalog kind
skill
Gateway key
openskills-skill-authoring
Source
github.com/geeksfino/openskills