writing-skills

Automate the six-phase workflow for writing, testing, and refining Claude Code skills.

Updated Mar 2, 2026
One-click install
npx skills add https://github.com/patanet7/skillproof --skill writing-skills-patanet7
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skills
Source: https://github.com/patanet7/skillproof/tree/main/skills/writing-skills
Command: npx skills add https://github.com/patanet7/skillproof --skill writing-skills-patanet7

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires anthropic, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Creating and maintaining Claude Code skills often suffers from inconsistent quality, unclear discovery signals, and fragmented guidance. This Skill provides a structured, end-to-end approach to write, test, and refine skills so they are reliable, maintainable, and easy to discover.

Core Features & Use Cases

  • A six-phase workflow (Capture Intent, Baseline Testing, Draft Skill, Evaluate, Refine, Optimize) to systematically build robust skills.
  • Clear guidance for every skill type (discipline, workflow, reference, and hybrid) and alignment with the skill-tdd testing methodology.
  • Bundled references and scripts to assist authors and evaluators, plus benchmarking and evaluation pipelines to prove skill quality.

Quick Start

Trigger the six-phase skill-writing workflow by describing the desired skill, then follow Phase 1 through Phase 6 to produce a tested, deployable SKILL.md.

Frequently Asked Questions about writing-skills

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

FAQPage Schema
How do I create and test Claude Code skills systematically?

To create and test Claude Code skills, use a six-phase workflow from intent capture to deployment, applying frontmatter validation and evaluation tooling to ensure reliable, discoverable outputs.

What is the best way to standardize skill development and ensure consistent quality?

Standardize skill development by enforcing frontmatter validation, token budgets, and bundled resources, relying on evaluation pipelines to benchmark and prove consistent skill quality across all types.

Does this skill writing workflow support different skill types like reference and discipline?

Yes, the skill writing workflow supports discipline, workflow, reference, and hybrid skill types, providing clear alignment with skill-tdd testing methodology to validate each format reliably.

How do I evaluate and refine a drafted SKILL.md before deployment?

Evaluate and refine a drafted SKILL.md by running benchmarking and evaluation pipelines to test outputs, then iterating through the optimize phase to ensure token budgets and quality standards are met.

Why does my Claude Code skill fail frontmatter validation or exceed token limits?

Skills fail frontmatter validation or exceed token limits when structural metadata is incomplete or content is too dense; the workflow enforces validation and token budgets to prevent these deployment blockers.

Do I need bundled resources and scripts to build maintainable Claude Code skills?

Yes, bundled references and scripts assist authors and evaluators by standardizing the end-to-end process, ensuring skills remain maintainable, reliable, and easy to discover across the full lifecycle.