skill-creator

Guide creation of AI skills with SKILL.md structure and progressive disclosure.

Updated Dec 2, 2025
One-click install
npx skills add https://github.com/qlawmarq/dotfiles-common --skill skill-creator-qlawmarq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/qlawmarq/dotfiles-common/tree/main/skills/skill-creator
Command: npx skills add https://github.com/qlawmarq/dotfiles-common --skill skill-creator-qlawmarq

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a comprehensive guide for creating new AI skills, ensuring they are effective, well-structured, and adhere to best practices for extending AI capabilities.

Core Features & Use Cases

  • Skill Anatomy: Explains the structure of a skill (SKILL.md, scripts, references, assets).
  • Design Principles: Covers conciseness, progressive disclosure, and setting degrees of freedom.
  • Creation Process: Outlines a step-by-step guide from understanding the skill to iteration.
  • Use Case: A developer needs to create a new skill to help an AI agent interact with a specific internal API. They use this skill to understand the required format, best practices for documentation, and how to structure the skill's resources.

Quick Start

Use the skill-creator skill to learn how to create a new AI skill.

Frequently Asked Questions about skill-creator

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

FAQPage Schema
How do I create a new AI skill for agent development?

To create a new AI skill, you structure a SKILL.md file, bundle supporting resources like scripts and references, and follow a step-by-step process from understanding the skill to iteration. This ensures the agent skill is effective and well-structured.

What is progressive disclosure in AI skill design?

Progressive disclosure in AI skill design is a core principle that sets degrees of freedom for the agent. It guides how to structure SKILL.md files concisely, ensuring the AI processes only the necessary information at the right time.

What's the best way to structure an AI agent skill?

The best way to structure an AI agent skill is to organize its anatomy into a main SKILL.md file alongside bundled scripts, references, and assets. Adhering to this structure ensures proper documentation and extends AI capabilities effectively.

How do I bundle scripts and references when building agent skills?

You bundle scripts and references when building agent skills by placing them alongside the core SKILL.md file within the skill directory. This resource organization allows the AI agent to access necessary logic and documentation reliably.

Do I need programming experience to develop AI skills with this guide?

You need intermediate implementation depth to develop AI skills using this guide. The process details skill anatomy, design principles, and the creation process, requiring a developer's understanding of structuring documentation and bundling resources.

When should I not use progressive disclosure for skill creation?

You should reconsider progressive disclosure for skill creation when an AI task requires accessing all available context simultaneously without constraints. Setting strict degrees of freedom may limit the agent's ability to process complex, highly interdependent data.