A comprehensive reference for building and organizing AI agent skills across Claude Code, KiloCode, OpenClaw, and OpenAI Codex. Covers SKILL.md specifications, folder structures, mode-scoped skills, agent orchestration, and self-hosted model configuration.
This repository also configures its own agents. See what Agent-Skill-Architecture-Guide tells them →
shane9coy/Agent-Skill-Architecture-Guide
Skill Claude CodeCodex
Use when the user asks to copy, install, refresh, or update a repo-root AGENTS.md file from their canonical global instruction source. Also use when the user says "agent copy" or wants a repo-local AGENTS.md with global operating rules plus project-specific guidance.
shane9coy/Agent-Skill-Architecture-Guide
Skill Claude CodeCodex
Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).
shane9coy/Agent-Skill-Architecture-Guide
Skill Claude CodeCodex
Install, create, scaffold, and validate new skills in Codex-first skill folders such as .codex/skills/ and .agents/skills/. Use when adding a skill from a URL, GitHub repo, zip file, or markdown content, or when creating a new skill from scratch. Also use for validating existing skills, fixing registration issues, or…