Why should I use this spec for my AI skills?

It prevents silent failures by enforcing schema validation and standard directory structures, ensuring your AI tools remain functional as agent platforms evolve.

What is the Skill Specification framework?

It is a formal standard designed to make AI agent capabilities compatible and robust across different platforms like Claude Code, Cursor, and Codex.

Which AI agents are compatible with this specification?

The spec is built for Claude Code, Codex CLI, Cursor, Amp, Letta (memGPT), and is designed to be future-proof for upcoming agentic systems.

How does progressive disclosure work in this spec?

It optimizes performance by loading only essential metadata at startup and deferring detailed documentation and scripts until the skill is actually activated.

Skill Specification Framework

Name: Skill Specification Framework
Author: plurigrid

byplurigrid

•

開発者ツール

Standardizes agent capabilities for seamless compatibility across Claude Code, Cursor, Codex, and other AI development environments.

The Skill Specification framework provides a formal, evolutionarily robust standard for creating and maintaining agent capabilities. By enforcing a strict schema for YAML frontmatter, directory structures, and metadata, it ensures that specialized AI instructions remain functional and discoverable across multiple platforms. This skill helps developers prevent silent failures in their AI workflows through automated validation while supporting advanced patterns like progressive disclosure and triadic classification for complex, compositional agent behaviors.

主な機能

01Progressive disclosure patterns to optimize token management

02Cross-platform compatibility for Claude, Codex, Cursor, and Amp

03Standardized directory structure for scripts, assets, and references

048 GitHub stars

05Strict YAML schema validation for metadata and field constraints

06Advanced triadic classification (GF(3)) for skill interleaving

ユースケース

01Developing reusable agent capabilities that function consistently across different IDEs

02Validating skill metadata to prevent silent execution failures in CI/CD pipelines

03Organizing complex prompt engineering projects into modular, scalable components

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add plurigrid/asi skill-specification

For use in Claude.ai and ChatGPT

Download Skill