write-a-skill

Create structured agent skills with SKILL.md frontmatter and optional resources.

181|29|Updated Apr 21, 2026
One-click install
npx skills add https://github.com/iusztinpaul/squid --skill write-a-skill-iusztinpaul
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-a-skill
Source: https://github.com/iusztinpaul/squid/tree/main/skills/write-a-skill
Command: npx skills add https://github.com/iusztinpaul/squid --skill write-a-skill-iusztinpaul

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a formal, repeatable blueprint for creating new agent skills, ensuring consistent structure, documentation, and bundled resources so teams can ship reliable capabilities faster.

Core Features & Use Cases

  • Structured templates: Enforces a root SKILL.md with name/description frontmatter and optional REFERENCE.md, EXAMPLES.md, and a scripts/ directory for deterministic tasks.
  • Guided workflow: Includes a step-by-step process (gather requirements, draft, review) to produce clear, reusable skills.
  • Maintainability and discovery: Supports optional reference materials and a standard review checklist to ensure consistency across skills.

Quick Start

Create a new skill directory with SKILL.md frontmatter (name and description), and add optional REFERENCE.md, EXAMPLES.md, and scripts/ only if deterministic tasks are needed, following the template to outline workflows.

Frequently Asked Questions about write-a-skill

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

FAQPage Schema
How do I standardize agent skill creation with consistent frontmatter?

You can standardize agent skill creation by using a formal blueprint that enforces a root SKILL.md file with YAML frontmatter, ensuring consistent structure, documentation, and bundled resources across your team.

What files do I need to structure a new agent skill?

To structure a new agent skill, you need a root SKILL.md file for frontmatter, and you can optionally add REFERENCE.md, EXAMPLES.md, and a scripts/ directory for deterministic tasks and supporting materials.

What is the guided workflow for developing reliable capabilities?

The guided workflow for developing capabilities follows a step-by-step process: gather requirements, draft the skill structure, and review the output against a standard checklist to ensure maintainability and clear documentation.

When do I need to include a scripts directory in my skill template?

You need to include a scripts directory in your skill template only when deterministic tasks are required, allowing you to bundle executable scripts alongside optional reference materials and examples.

Does this skill creation template require any external dependencies?

No, this skill creation template requires no external dependencies, allowing you to create, structure, and validate new agent skills directly within your existing environment.

What is the best way to accelerate skill creation for my team?

The best way to accelerate skill creation is to adopt a repeatable template that enforces frontmatter validation and bundles optional resources, allowing teams to ship reliable capabilities faster through a standardized review checklist.