subagent-skills
Sol + Luna layered subagent templates, skill, and demo for Codex / Claude Code / Pi (high-IQ leader + cheap workers)
Install with your AI
Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.
Install and set up subagent-skills (git-clone project) into my current project. Found on https://claudeers.com/subagent-skills Repo: https://github.com/Yuri-NagaSaki/subagent-skills Homepage/docs: https://catcat.blog/2026/08/sol-luna-layered-subagents-codex-claude-pi.html Detected install method: git-clone → git clone https://github.com/Yuri-NagaSaki/subagent-skills Category: automation. Platforms: cli, api. Read the repo's README for exact setup and env vars, then install it and wire it into my project. Claudeers Health Verdict: active; community-verified: false. Confirm the source before running anything.
git clone https://github.com/Yuri-NagaSaki/subagent-skills
// compatibility
| Platforms | cli, api |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | MIT |
| Pricing | open-source |
| Language | Shell |
subagent-skills
Project-level templates and a setup skill for Sol (leader) + Luna (workers) multi-agent workflows in Codex, Claude Code, and Pi.
Blog (Chinese, longer write-up):
https://catcat.blog/2026/08/sol-luna-layered-subagents-codex-claude-pi.html
Install
npx skills add Yuri-NagaSaki/subagent-skills -g -y
Claude Code only:
npx skills add Yuri-NagaSaki/subagent-skills -g -a claude-code -y
Project-local:
npx skills add Yuri-NagaSaki/subagent-skills -y
List skills in this repo:
npx skills add Yuri-NagaSaki/subagent-skills -l
Installed skill: sol-luna-setup.
After install, ask the agent to run that skill on the current project.
Optional: write project files
git clone https://github.com/Yuri-NagaSaki/subagent-skills.git
export OPENAI_API_KEY=... # env only; never commit
bash subagent-skills/scripts/bootstrap.sh /path/to/project
Creates or merges:
.codex/config.toml,.codex/agents/luna_*.tomlAGENTS.md.claude/agents/luna-*.md,CLAUDE.mdscripts/prepare-luna-catalog.sh
Edit base_url in .codex/config.toml for your provider.
Layout
skills/sol-luna-setup/ # discovered by npx skills
templates/ # codex / claude / pi copies
scripts/bootstrap.sh
scripts/prepare-luna-catalog.sh
demo/ # tiny auth sample + npm test
docs/sol-luna-catalog-fix.md
Sol cannot spawn Luna
Common error:
Unknown model `gpt-5.6-luna` for spawn_agent
bash scripts/prepare-luna-catalog.sh "$(pwd)/.codex/models-v1.json"
Point model_catalog_json at that file. Keep multi_agent_v2 = false.
Details: docs/sol-luna-catalog-fix.md.
Smoke checks
codex exec --sandbox read-only -c 'model="gpt-5.6-sol"' \
"Reply: SOL_SMOKE_OK" </dev/null
codex exec --sandbox read-only -c 'model="gpt-5.6-luna"' \
"Reply: LUNA_SMOKE_OK" </dev/null
codex exec --sandbox read-only \
"Use luna_scout per AGENTS.md; start answer with SCOUT_DONE" </dev/null
codex exec reads stdin; always redirect </dev/null in scripts.
Demo:
cd demo && npm test
Roles
| Role | Model | Notes |
|---|---|---|
| Main session | gpt-5.6-sol | Plan, review, commit/PR |
| luna_scout | gpt-5.6-luna | Read-only |
| luna_worker | gpt-5.6-luna | Bounded writes; no commit |
| luna_critic | gpt-5.6-luna | Adversarial review |
| luna_tester | gpt-5.6-luna | Run specified tests |
Safety
- Do not commit API keys, host credentials, or private IPs.
- Use env vars (
OPENAI_API_KEY,GATEWAY_API_KEY). - Ignore
models-v1.jsonin git (generated locally). - Demo auth code is not production-safe.
License
// faq
What is subagent-skills?
Sol + Luna layered subagent templates, skill, and demo for Codex / Claude Code / Pi (high-IQ leader + cheap workers). It is open-source on GitHub.
Is subagent-skills free to use?
subagent-skills is open-source under the MIT license, so it is free to use.
What category does subagent-skills belong to?
subagent-skills is listed under automation in the Claudeers registry of Claude-compatible tools.
// embed badge
[](https://claudeers.com/subagent-skills)
// retro hit counter
[](https://claudeers.com/subagent-skills)
// reviews
// guestbook
// related in Automation & Workflows
🔓
🔓The API to search, scrape, and interact with the web at scale. 🔥
🔓🌐 Make websites accessible for AI agents. Automate tasks online with ease.
🔓An open-source long-horizon SuperAgent harness that researches, codes, and creates. With the help of sandboxes, memories, tools, skill, subagents and message…