skill-writer

Validate SKILL.md frontmatter and organize Skill resources.

4|Updated Aug 25, 2024
One-click install
npx skills add https://github.com/chnots/chnots --skill skill-writer-chnots
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-writer
Source: https://github.com/chnots/chnots/tree/main/.opencode/skills/skill-writer
Command: npx skills add https://github.com/chnots/chnots --skill skill-writer-chnots

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creating and validating well-formed Skill units and SKILL.md frontmatter to enable reliable AI discovery and execution.

Core Features & Use Cases

  • Frontmatter validation: Ensures name and description exist and follow rules.
  • Structured content guidelines: Provide Quick Start, Instructions, Examples.
  • Progressive disclosure support: Recognizes optional scripts/references/assets and how to use them.

Quick Start

Create a new Skill by following the template and placing SKILL.md at the Skill root to initialize discovery.

Frequently Asked Questions about skill-writer

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

FAQPage Schema
How do I validate YAML frontmatter for an AI agent skill?

To validate YAML frontmatter, inspect the SKILL.md file to ensure name and description fields exist and follow formatting rules. This process verifies YAML validity and proper structure to enable reliable AI discovery and execution of the skill.

What is the correct file structure for organizing optional resources in skill design?

The correct file structure for skill design applies an official directory layout to organize optional scripts, references, and assets. You must ensure file paths and naming conventions are correct so the AI can properly locate and activate these resources.

How do I make an AI skill activate on relevant user queries?

To make an AI skill activate on relevant queries, craft a clear description in the SKILL.md frontmatter. The description triggers discovery by matching user intent, ensuring the skill initializes correctly when specific queries are received.

What should be included in the SKILL.md content for a new agent skill?

The SKILL.md content should include structured sections like Quick Start, Instructions, and Examples. This structured content guidelines approach supports progressive disclosure by documenting dependencies and components when they are present.

Do I need to document dependencies and components when writing a skill?

Yes, you need to document dependencies and components when writing a skill if they are present. The validation process checks for these optional resources and ensures they are properly recorded within the SKILL.md file for complete operational transparency.