skills.rest
InditexTech
InditexTechOFFICIAL
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/InditexTech/weavejs --skill write-a-skill-inditextech
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
bbohhu-progbbohhu-prog

skill-creator

Generates kebab-case folder structures and SKILL.md frontmatter for new or existing skills.

Community
Basic
erclxerclx
2

create-skill

Generate compliant skill directories and SKILL.md files with validated frontmatter.

Community
Intermediate
Puzzle9900Puzzle9900

generic-skill-creator-structure

Establishes folder layout, naming conventions, and SKILL.md format for creating compliant skills.

Community
Basic
MrOwaisAbdullahMrOwaisAbdullah
1

book-structure-generator

Generate Docusaurus book structures with chapter hierarchies and sidebars.ts configuration.

Community
Intermediate