write-skill

Creates and revises Claude Code skills through interview, template-based authoring, and independent subagent review.

Updated Aug 7, 2026
One-click install
npx skills add https://github.com/sagittaras/agentic-workflow --skill write-skill-sagittaras
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-skill
Source: https://github.com/sagittaras/agentic-workflow/tree/main/skills/write-skill
Command: npx skills add https://github.com/sagittaras/agentic-workflow --skill write-skill-sagittaras

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing a well-formed Claude Code skill requires correct frontmatter configuration (name, description, when_to_use, model, effort), a structured SKILL.md body, and triggering boundaries against neighboring skills. Doing this by hand produces skills that fire in the wrong situations, run on the wrong model, or duplicate existing skills. ## Core Features & Use Cases - Guided interview and design: Extracts purpose, triggers, inputs, tools, and naming from the user, then proposes a model × effort pairing from a decision matrix before writing anything. - Convention-driven authoring: Writes SKILL.md from a mandatory template, enforces naming rules (<action>-<object>), the 1,536-character description budget, and documented rationale for every omitted frontmatter field. - Autonomous review loop: Submits the finished skill to an independent review subagent with a clean context, iterates on blocking findings, and escalates to the user only on defined conditions. - Use Case: Ask to create a skill for generating pull request descriptions; the skill interviews you about triggers and tools, drafts SKILL.md per the template, and runs review rounds until the reviewer approves. ## Quick Start Ask the assistant to create a new skill for your repeated workflow, for example: create a skill that drafts release notes from merged pull requests.

Frequently Asked Questions about write-skill

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

FAQPage Schema
How do I create a new Claude Code skill?

Invoke the write-skill workflow with a topic or name. It interviews you about purpose, triggers, and tools, drafts SKILL.md from the official template, and runs an independent subagent review before delivering the finished skill.

What frontmatter fields does a SKILL.md file require?

Every skill needs five explicit fields: name, description, when_to_use, model, and effort. The description and when_to_use fields share a 1,536-character budget, and omitted optional fields must be justified in comments.

How do I choose model and effort for a skill?

Use the model-effort matrix: haiku for mechanical tasks, sonnet for well-bounded work, opus for autonomous multi-step orchestration, and fable only when opus repeatedly fails. Effort ranges from low to max, with high as the default.

Can this skill edit an existing skill instead of creating one?

Yes, it reads the existing skill fully before interviewing, narrows the interview to what changes, edits in place rather than rewriting from the template, and sends the result through the same independent review loop.

When should I not use write-skill?

Do not use it for creating agents (use write-agent), rules in .claude/rules/ (use write-rule), project CLAUDE.md files (use write-claude-md), or for merely reviewing a finished skill, which belongs to review-skill.