skill-writer

Create and improve Agent Skills with SKILL.md workflows and YAML frontmatter validation.

Updated May 5, 2026
One-click install
npx skills add https://github.com/yanochka11/harness_bro --skill skill-writer-yanochka11
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-writer
Source: https://github.com/yanochka11/harness_bro/tree/main/.claude/skills/ported/skill-writer
Command: npx skills add https://github.com/yanochka11/harness_bro --skill skill-writer-yanochka11

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps AI developers and maintainers create, refine, and validate Agent Skills without losing important workflow details, trigger quality, or maintainability.

Core Features & Use Cases

  • Skill Authoring Workflow: Guides the creation and improvement of SKILL.md files with structured workflows, routing decisions, and validation steps.
  • Reference and Documentation Management: Helps organize supporting references, scripts, assets, specifications, and source records for reusable skills.
  • Trigger Optimization and Validation: Improves skill descriptions, checks activation behavior, and validates skill structure for reliable discovery.
  • Use Case: A developer building a new AI coding workflow can use this Skill to design the skill structure, write operational instructions, add supporting references, and verify the final package.

Quick Start

Use the skill-writer skill to create a new Agent Skill for automating code review workflows.

Frequently Asked Questions about skill-writer

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

FAQPage Schema
How do I create an Agent Skill with a structured SKILL.md workflow?

Creating an Agent Skill involves defining a SKILL.md file with structured workflows, routing decisions, YAML frontmatter metadata, and validation steps. This process organizes operational instructions and supporting references into a reusable, maintainable skill package.

How does YAML frontmatter validation work for Claude Code agent skills?

YAML frontmatter validation checks the metadata structure within SKILL.md files to ensure correct formatting and trigger optimization. This process validates skill descriptions and activation behavior so the agent reliably discovers and executes the intended workflow.

What's the best way to organize references and scripts for AI skill documentation?

Organizing references and scripts for AI skill documentation requires routing supporting assets, specifications, and source records within the skill structure. This ensures reusable artifacts are correctly mapped to the SKILL.md workflow for maintainable agent operation.

Can I use skill-writer to update and improve trigger descriptions for existing agent skills?

Yes, you can update and improve trigger descriptions for existing agent skills by refining the skill metadata and checking activation behavior. This trigger optimization validates the skill structure to maintain reliable discovery across different workflow contexts.

Do I need pyyaml installed to validate SKILL.md metadata structures?

Yes, pyyaml is required as a dependency to parse and validate the YAML frontmatter structures within SKILL.md files. This library enables the skill validation processes to check metadata formatting and ensure correct skill structure routing.

What are the limitations when designing skill creation workflows for complex coding tasks?

Designing skill creation workflows for complex coding tasks requires structured skill files and strict reference routing, meaning poorly structured inputs or missing validation steps can degrade trigger quality. Maintainability depends on proper artifact organization and YAML metadata accuracy.