write-a-skill

Create new agent skills with SKILL.md templates and directory structures.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/kehwar/pixi-square --skill write-a-skill-kehwar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-a-skill
Source: https://github.com/kehwar/pixi-square/tree/main/.agents/skills/write-a-skill
Command: npx skills add https://github.com/kehwar/pixi-square --skill write-a-skill-kehwar

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

The Skill provides a standardized framework for creating, documenting, and packaging new agent skills. Use when you want to define a consistent skill template and workflow for authors.

What problem does it solve?

It helps teams standardize how new agent skills are authored, organized, and distributed to reduce onboarding time and ambiguity.

Core Features & Use Cases

  • Provides a reusable SKILL.md template and recommended directory structure (skill-name/, SKILL.md, REFERENCE.md, EXAMPLES.md, scripts/).
  • Outlines a repeatable process for gathering requirements, drafting, and reviewing skills with stakeholders.
  • Supports optional references, examples, and scripts to extend capabilities.

Quick Start

Create a new skill by following the SKILL.md template and placing optional references and scripts 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 a new agent skill with proper documentation and frontmatter?

To structure a new agent skill, use a standardized template that establishes a directory layout with SKILL.md, frontmatter validation, and optional components like scripts and references. This ensures proper organization and progressive disclosure for authors.

What is the best way to standardize skill authoring and reduce onboarding time for a team?

The best way to standardize skill authoring is to implement a reusable template with a recommended directory structure. This reduces ambiguity by enforcing consistent frontmatter validation and a repeatable process for gathering requirements, drafting, and reviewing skills.

How do I bootstrap an agent skill directory with bundled resources and examples?

You can bootstrap an agent skill directory by following a standard layout that includes skill-name/, SKILL.md, REFERENCE.md, EXAMPLES.md, and scripts/. This structure ensures bundled resources and optional components are correctly organized from the start.

Do I need specific dependencies to draft and publish a skill with a standard template?

No specific dependencies are required to draft and publish a skill with a standard template. The framework operates independently, allowing you to define, draft, and publish skills with clear documentation without external packages.

When should I include optional references and scripts when creating agent skills?

You should include optional references and scripts when you need to extend the capabilities of your agent skills. These bundled resources provide additional context and functionality beyond the standard SKILL.md template, supporting more complex workflows.

Why does my skill template require frontmatter validation during the authoring workflow?

Frontmatter validation is required during the authoring workflow to ensure metadata consistency across distributed skills. It enforces proper structure and reduces errors by validating the standardized template before publication.