create-skill

Create AI agent skills with SKILL.md files and index updates.

1|Updated Mar 12, 2026

Search Tags:#automation #documentation #skill creation #agent development #framework #gai

Ready to run

npx skills add https://github.com/bketelsen/truenas-mcp --skill create-skill-bketelsen

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: create-skill
Source: https://github.com/bketelsen/truenas-mcp/tree/main/.gaai/core/skills/cross/create-skill
Command: npx skills add https://github.com/bketelsen/truenas-mcp --skill create-skill-bketelsen

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill streamlines the process of creating new, spec-compliant skills for AI agents, ensuring consistency and discoverability within the .gaai framework.

Core Features & Use Cases

Guided Skill Creation: Follows the agentskills.io specification and GAAI best practices.
Automated Indexing: Ensures new skills are registered in relevant indices (skills-index.yaml, README.skills.md).
Use Case: When a new capability is needed that no existing skill covers, activate this skill to generate the necessary SKILL.md file, define inputs/outputs, and update all documentation.

Quick Start

Use the create-skill skill to author a new skill for generating user stories.

Frequently Asked Questions about create-skill

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

FAQPage Schema

How do I create new AI agent skills that follow the agentskills.io specification?▼

Authoring AI agent skills involves defining the skill name, category, inputs, and outputs in a structured SKILL.md file. This ensures proper documentation and consistency within the GAAI framework before indexing.

What is the best way to automate documentation and indexing for agent development?▼

Automated indexing registers new skills directly into skills-index.yaml and README.skills.md files. This maintains documentation consistency and ensures your agent capabilities are discoverable across project and core catalogs.

When do I need to define specific inputs and outputs for AI agent skills?▼

You must define inputs and outputs when authoring a new self-contained skill that no existing capability covers. This structured definition is required for proper indexing in core and project skill catalogs.

Can I use this approach to build capabilities for any framework?▼

This guided authoring approach specifically targets the GAAI framework and agentskills.io specification. It ensures new skills are self-contained and properly indexed within the framework's core and project skill catalogs.

What are the limitations of manually authoring self-contained AI agent skills?▼

Manually authoring skills risks missing spec compliance and proper indexing in skills-index.yaml. Without a guided creation process, your self-contained capabilities may lack the structured definition needed for framework discoverability.