skill-writing

Create and validate agent skills with frontmatter and TDD workflows.

1|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/NeuveAI/perfagent-cli --skill skill-writing-neuveai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-writing
Source: https://github.com/NeuveAI/perfagent-cli/tree/main/.agents/skills/skill-writing
Command: npx skills add https://github.com/NeuveAI/perfagent-cli --skill skill-writing-neuveai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill Writing guide standardizes how to create, structure, and validate agent skills (SKILL.md), ensuring frontmatter, documentation, and testing practices are consistent across projects.

Core Features & Use Cases

  • Establishes a uniform frontmatter schema (name, description) for every skill.
  • Enforces a test-driven development mindset with RED/GREEN/REFACTOR workflows and a mandatory checklist.
  • Guides on crafting concise instructions, avoiding workflow summaries, and maintaining scalable Skill structures.

Quick Start

Draft a new SKILL.md following the frontmatter rules and perform a RED-GREEN-REFACTOR cycle to validate the skill.

Frequently Asked Questions about skill-writing

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

FAQPage Schema
How do I create an agent skill with consistent frontmatter and documentation?

To create an agent skill, draft a SKILL.md file with mandatory frontmatter including name and description, then structure the Markdown body with optional references or scripts directories to ensure consistent documentation across projects.

What is the test-driven development workflow for validating agent skills?

The test-driven development workflow for agent skills follows a RED-GREEN-REFACTOR cycle, enforcing a mandatory checklist to validate instruction compliance and ensure high-quality skill behavior before deployment.

Why does my agent ignore instructions in the skill documentation?

Agents ignore instructions when skill documentation lacks concise structure or mandatory frontmatter. Refactoring the SKILL.md to enforce test-driven validation and clear instructions improves agent compliance.

What is the required metadata schema for standardizing agent skills?

The required metadata schema for standardizing agent skills includes mandatory frontmatter fields for name and description, alongside a clearly structured Markdown body to maintain project-wide consistency.

Can I use this approach to refactor existing skills across multiple projects?

Yes, you can refactor existing skills across projects by applying the uniform frontmatter schema and governance checks, ensuring all current skills meet the standardized documentation and testing practices.