write-a-skill

Draft structured agent skills with a SKILL.md template and optional references.

195|16|Updated Feb 18, 2025

Search Tags:#template #documentation #validation #yaml #skill #frontmatter #draft

Ready to run

npx skills add https://github.com/InditexTech/weavejs --skill write-a-skill-inditextech

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: write-a-skill
Source: https://github.com/InditexTech/weavejs/tree/main/code/.agents/skills/write-a-skill
Command: npx skills add https://github.com/InditexTech/weavejs --skill write-a-skill-inditextech

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a repeatable, well-structured workflow for authoring new agent skills, ensuring consistent organization, documentation, and bundled resources for reuse.

Core Features & Use Cases

Clear skill scaffolding: defines name, description, structure, and optional components.
Guided workflow: steps to gather requirements, draft SKILL.md, and review with users.
Templates and references: includes a SKILL.md template, example references, and optional scripts to support deterministic tasks.

Quick Start

Draft a new skill folder named after the skill, place SKILL.md at its root following the template, then add optional resources as needed.

Frequently Asked Questions about write-a-skill

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

FAQPage Schema

How do I structure and draft a new agent skill with valid YAML frontmatter?▼

You can draft a new agent skill by creating a folder and placing a SKILL.md file at its root. The file must follow a consistent template with YAML frontmatter containing the required name and description fields.

What is the correct folder structure and documentation needed for creating reusable agent skills?▼

Creating reusable agent skills requires a root folder named after the skill, containing a SKILL.md file for documentation and optional bundled references or scripts to support deterministic tasks and ensure consistent organization.

Can I add optional scripts and reference files when scaffolding a skill template?▼

Yes, you can add optional scripts and example references within the skill folder during scaffolding. These components support deterministic tasks and provide bundled resources alongside the required SKILL.md documentation.

What is the best way to validate a drafted skill before publishing?▼

The best way to validate a drafted skill is to check that the resulting folder contains valid components and documentation. Verify the SKILL.md template is correctly applied and the YAML frontmatter includes both name and description.

Does the skill scaffolding workflow require any external dependencies or components?▼

No external dependencies or components are required to use the skill scaffolding workflow. The process relies entirely on applying a consistent template to gather requirements, draft SKILL.md, and add optional references.