write-a-skill

Create structured AI agent skills with SKILL.md, REFERENCE.md, and EXAMPLES.md files.

Updated Sep 30, 2024

Search Tags:#AI agent #skill creation #structured development #resource bundling #programming assistance

Ready to run

npx skills add https://github.com/phillip-hirsch/dotfiles --skill write-a-skill-phillip-hirsch

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: write-a-skill
Source: https://github.com/phillip-hirsch/dotfiles/tree/main/.agents/skills/write-a-skill
Command: npx skills add https://github.com/phillip-hirsch/dotfiles --skill write-a-skill-phillip-hirsch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill helps users create new agent skills with a proper structure, progressive disclosure, and bundled resources, streamlining the process of building and organizing new skills.

Core Features & Use Cases

Structured Skill Creation: Offers a detailed guide on creating skills with required components like SKILL.md, REFERENCE.md, and EXAMPLES.md.
Progressive Disclosure: Encourages step-by-step development, from gathering requirements to final review.
Resource Bundling: Includes utility scripts, reference materials, and assets for efficient skill development.

Quick Start

Run the write-a-skill command to initiate the skill creation process.

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 an AI agent skill with required components and resources?▼

To structure an AI agent skill, you need mandatory frontmatter, comprehensive instructions in files like SKILL.md, and optional resource directories for assets, references, and scripts. This structured approach ensures your skill is properly organized and progressively disclosed to users.

What is the best way to create new AI agent skills with bundled resources?▼

The best way to create new AI agent skills is using a structured template that includes mandatory frontmatter and bundled resources. This approach streamlines development by providing utility scripts, reference materials, and assets within dedicated directories for efficient skill management.

What files do I need to build a structured AI programming assistance skill?▼

To build a structured AI programming assistance skill, you need core files like SKILL.md, REFERENCE.md, and EXAMPLES.md. These files provide mandatory frontmatter, comprehensive instructions, and bundled resource directories to ensure proper progressive disclosure during development.

Can I use progressive disclosure to develop structured agent skills step by step?▼

Yes, you can use progressive disclosure to develop structured agent skills step by step. This method guides you from gathering initial requirements through final review, ensuring your AI programming assistance skill includes proper frontmatter and bundled resources without overwhelming the system.

Why does my AI agent skill creation process lack clear structure and resource management?▼

Your AI agent skill creation process lacks clear structure if it omits mandatory frontmatter, comprehensive instructions, or bundled resource directories. Applying a structured development template with utility scripts and reference materials streamlines organization and fixes resource management issues.

Are there limitations to creating skills without optional resource directories and utility scripts?▼

Creating skills without optional resource directories and utility scripts limits your ability to bundle references and assets efficiently. While mandatory frontmatter and instructions are required, including structured resource components significantly streamlines development and enhances programming assistance capabilities.