write-a-skill

Draft SKILL.md structures and workflow instructions for archon-cli skills.

7|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/ste-bah/archon-cli --skill write-a-skill-ste-bah
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-a-skill
Source: https://github.com/ste-bah/archon-cli/tree/main/assets/skills/write-a-skill
Command: npx skills add https://github.com/ste-bah/archon-cli --skill write-a-skill-ste-bah

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users design new archon-cli skills with the correct structure, clear triggers, and well-scoped instructions so they can be discovered and used reliably by the agent.

Core Features & Use Cases

  • Requirements Gathering: Captures the task, target contexts, trigger keywords, and whether the skill needs scripts or reference material.
  • Skill Drafting: Produces a proper SKILL.md with frontmatter, concise operational steps, and progressive disclosure guidance.
  • Review and Iteration: Walks the user through feedback, refinement, and approval before writing files.
  • Skill Packaging: Supports project-local or global placement and reminds the user to restart archon after creation.
  • Use Case: A user wants a repeatable workflow for classifying incoming support tickets, so this Skill helps define the triggers, scope, and final SKILL.md layout.

Quick Start

Use the write-a-skill skill to help me design a new archon skill for my task and draft the SKILL.md structure.

Frequently Asked Questions about write-a-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a reusable skill for archon-cli?

To create a reusable archon-cli skill, you draft a SKILL.md file with valid YAML frontmatter, concise operational steps, and progressive disclosure guidance. This skill helps define triggers, scope, and installation paths for reliable agent discovery.

What is progressive disclosure in skill authoring?

Progressive disclosure in skill authoring structures instructions so the agent receives concise operational steps first, with optional scripts or references available when deterministic support or deeper documentation is needed. This approach keeps the skill scope clear and reliable.

Does my archon skill require YAML frontmatter?

Yes, archon skills require valid YAML frontmatter containing at least the name and description fields. This metadata is necessary for the agent to properly discover and trigger the skill during workflows.

How do I package and install an archon skill locally or globally?

To package and install an archon skill, you finalize the SKILL.md structure and choose project-local or global placement. After writing the files, you must restart archon to load the new skill and make it available for workflows.

Can I bundle scripts and reference material inside an archon skill?

Yes, you can bundle optional scripts or reference material inside an archon skill. These resources provide deterministic support or deeper documentation when the core instruction steps require additional context for the agent.