example-skills

a-i--skills

A composable skill framework for AI agent orchestration -- 101 production-ready skill modules spanning creative, technical, enterprise, and governance domains, organized into a federated registry with multi-agent runtime support.

Part of ORGAN-IV: Taxis -- the orchestration and governance layer of the ORGAN system.

---

Table of Contents

• Product Overview
• Why This Exists
• Orchestration Philosophy
• Technical Architecture
• Installation and Quick Start
• Skill Catalog
• Skill Specification Format
• Federation Protocol
• Tooling and Scripts
• Cross-Organ Integration
• Related Work
• Contributing
• License
• Author

---

Product Overview

a-i--skills is a structured repository of 101 AI agent skills -- self-contained instruction modules that teach large language models how to perform specialized tasks in a repeatable, composable way. Each skill is a directory containing a SKILL.md file with YAML frontmatter (metadata for discovery and activation) and Markdown content (the actual instructions an agent follows).

The repository serves three distinct functions:

1. Skill Library -- A browsable catalog of 171 skills across 12 categories, from algorithmic art generation to security threat modeling, each with standardized metadata, optional helper scripts, reference documentation, and asset templates.

2. Orchestration Infrastructure -- Python tooling for skill validation, registry generation, health checking, and multi-agent bundle distribution. A built-in MCP (Model Context Protocol) server enables runtime skill discovery and planning.

3. Federation Specification -- A published protocol that allows third-party skill repositories to be discovered, validated, and consumed by any compatible agent, enabling a decentralized ecosystem of interoperable skill providers.

The skills themselves range from beginner-level single-file instructions to advanced multi-file modules with executable scripts, OOXML schema references, and comprehensive troubleshooting guides. Four document-processing skills (DOCX, PDF, PPTX, XLSX) demonstrate production-grade complexity -- these are the same skills that power Claude's native document creation capabilities.

Key Metrics

Dimension	Value
Total skills	101 (97 example + 4 document)
Skill categories	12
Multi-agent runtimes supported	4 (Claude Code, Codex, Gemini CLI, Claude API)
Total files	~3,745
Repository size	~5.2 MB
Federation schema version	1.1 (stable)
Skill spec version	Current

---

Why This Exists

AI agents are increasingly capable of executing complex, multi-step tasks, but their effectiveness depends heavily on the quality of instruction they receive. A generic prompt produces generic output. A well-structured skill -- with domain-specific vocabulary, explicit constraints, worked examples, and validation criteria -- produces expert-level output repeatedly.

The challenge is organizational: how do you manage dozens or hundreds of such skills across multiple agent runtimes, ensure they remain valid as specifications evolve, and enable external contributors to build compatible skills without centralized coordination?

This repository answers that question with three architectural decisions: