skill-writer

Structure SKILL.md frontmatter and content for Claude Code Skills.

7|Updated Jan 18, 2026
One-click install
npx skills add https://github.com/consuelohq/openengineer --skill skill-writer-consuelohq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-writer
Source: https://github.com/consuelohq/openengineer/tree/main/skills/skill-writer
Command: npx skills add https://github.com/consuelohq/openengineer --skill skill-writer-consuelohq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Guides users through creating well-structured Agent Skills for Claude Code and ensures correct frontmatter, naming, and structure.

Core Features & Use Cases

  • Step-by-step guidance to design SKILL.md frontmatter with required fields
  • Templates and best practices for skill structure (optional references, scripts, assets)
  • Validation and troubleshooting for skill discovery and activation

Quick Start

Describe your intended Skill and I will guide you through creating its SKILL.md, frontmatter, and supporting structure.

Frequently Asked Questions about skill-writer

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

FAQPage Schema
How do I write a SKILL.md file for Claude Code?

To write a SKILL.md file for Claude Code, you must define its frontmatter with required fields and organize the content according to naming rules. This ensures your custom Agent Skill is properly defined and discoverable by the tooling.

What is the required structure for Claude Agent Skills?

A Claude Agent Skill requires a SKILL.md file with correctly formatted frontmatter and content. It can also include optional references, scripts, and assets to support the skill's core functionality and execution.

How do I validate skill discovery and activation for Claude Code?

You validate skill discovery by checking the SKILL.md frontmatter against naming rules, description requirements, and safety checks. This troubleshooting process ensures the skill activates correctly within the automation tooling environment.

What fields are required in SKILL.md frontmatter?

SKILL.md frontmatter requires specific naming and description fields to ensure compliance and discoverability. Optional fields can be added to support scripts, assets, and references within the skill structure.

Can I update an existing SKILL.md file without breaking its structure?

You can update an existing SKILL.md file by validating the new frontmatter and content against required naming rules and safety checks. This ensures the updated skill remains discoverable and structurally compliant.