add-skill

Create and refine SKILL.md files with required frontmatter and structure.

Updated Jan 19, 2026

Search Tags:#documentation #markdown #validation #yaml #frontmatter #skill-creation

Ready to run

npx skills add https://github.com/andrewkoumoudjian/personnal-setup --skill add-skill-andrewkoumoudjian

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: add-skill
Source: https://github.com/andrewkoumoudjian/personnal-setup/tree/main/.opencode/skill/add-skill
Command: npx skills add https://github.com/andrewkoumoudjian/personnal-setup --skill add-skill-andrewkoumoudjian

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Create and refine agent skills by guiding the structure and frontmatter of SKILL.md, ensuring consistent formatting and discoverability.

Core Features & Use Cases

Enforces required frontmatter with name and description
Validates file organization and optional references/assets for scalable skill content
Promotes consistent templates for skill documentation in OpenCode or Claude

Quick Start

Create or update a skill by following this template and its frontmatter requirements.

Frequently Asked Questions about add-skill

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

FAQPage Schema

How do I create a valid SKILL.md file with correct frontmatter?▼

To create a valid SKILL.md file, you must include frontmatter with at least the required name and description fields. This ensures proper skill documentation structure and discoverability across platforms like OpenCode or Claude.

What is the required frontmatter for agent skill creation?▼

The required frontmatter for agent skill creation includes mandatory name and description fields. Proper validation also checks optional metadata like keywords, dependencies, components, and safety attributes to ensure a well-formed skill unit.

How do I organize optional references and assets when writing a SKILL.md file?▼

When writing a SKILL.md file, you organize optional references and assets by following a consistent template that validates file organization. This structural validation ensures your skill content remains scalable and properly formatted for agent use.

Can I update existing skill descriptions without breaking the markdown validation?▼

You can update existing skill descriptions safely by enforcing frontmatter requirements and validating metadata like keywords and dependencies. This refinement process ensures your updated markdown maintains a valid skill unit structure.

What is the best way to validate safety and metadata in skill documentation?▼

The best way to validate safety and metadata in skill documentation is by enforcing frontmatter requirements and checking structural organization. This validation process ensures your SKILL.md file meets all necessary safety and component standards.