Skill-Based Architecture transforms fragmented instructions and oversized documentation files into a dedicated skills directory. It provides a single source of truth for AI agents, replacing scattered rules found in agent-specific configuration files with a standardized contract.
Follow the documented setup, then try a first task.
Installs: The skill-based-architecture plugin, whose declared skill source is the repository root. · Claude Code
Enter this command in a Claude Code agent session to add the author's plugin marketplace.
/plugin marketplace add WoJiSama/skill-based-architecture
After adding the marketplace, enter this command in the Claude Code agent session to install the plugin.
/plugin install skill-based-architecture@skill-based-architecture
Installs: A local clone of the complete skill-based-architecture repository placed next to the target project. · Cursor, Codex, Gemini, Windsurf, OpenCode, another file-aware harness
Run from: The target project's directory, so ../skill-based-architecture is created next to it.
In a terminal opened in the target project's directory, clone the repository into the sibling path ../skill-based-architecture.
git clone https://github.com/WoJiSama/skill-based-architecture.git \ ../skill-based-architecture
Uses skill-based-architecture
Use skill-based-architecture to organize this project's rules.
Uses skill-based-architecture
Read `../skill-based-architecture/SKILL.md`, then use it to organize this project's rules.
Claude
Codex
Cursor
Gemini CLI
Copilot
Windsurf
OpenCode
Hermes