fmind/agent-supagents / skills/supagent
supagent
UnverifiedCompile one Markdown role file into native subagent profiles for Antigravity, Claude Code, Codex, Copilot, Cursor, Gemini CLI, Grok, Kilo, and OpenCode.
Supagent
Compile one Markdown role file with shared instructions and explicit native target blocks into per-harness subagent definitions. Read usage and configuration for target paths and precedence, and compatibility evidence for verified host versions.
Workflow
- Inspect existing sources, generated outputs, Git status, and installed harness versions; preserve handwritten profiles and unrelated work.
- Pick project (
.agents/supagents/) or global (~/.agents/supagents/) scope, then scaffold only active harnesses:supagents init NAME --project --target claude --target codex - Write a bounded role: task inputs, allowed actions, handoff format, and stop conditions. Keep shared
name,description, and the body portable; put model, tool allowlists, and permission settings inside each host's uppercase target block after checking current host docs. - Preview diffs and mappings without writing:
Passsupagents build --project --diff--source-dir PATH --config FILEconsistently for custom or chezmoi layouts. - Compile and verify strictly with zero warnings, errors, drift, or obsolete files:
supagents build --project --strict supagents check --project --strict - Verify native discovery in each installed host separately from compilation and bounded runtime runs.
Native Formats
AGY,CLAUDE,COPILOT,CURSOR,GEMINI,GROK,KILO, andOPENCODEemit Markdown with merged YAML frontmatter.CODEXemits TOML (nameanddescriptionrequired) and stores the body plusAPPEND_BODYindeveloper_instructions.OUTPUToverrides an output path (relative paths resolve beside the source); custom targets in config can setformat: tomlandbody_key.- Shared
_*.mdpartials in the source directory factor repeated target settings and body slots ({{BODY}}) viaextends: _nameorextends: [_a, _b];TARGET: falsedisables an inherited target.
Gotchas
- Respect ownership markers: never insert a generated marker into a handwritten file; back up and reconcile into the source first.
- Preview deletions first: run
supagents clean --dry-runbefore authorizedsupagents clean; cleanup scans only configured output directories. - No implicit safety parity: Supagents passes target metadata verbatim without translating tools or validating full host schemas, and role instructions alone do not enforce permissions.
- Do not write deployed home during chezmoi edits: compile into chezmoi source paths (
--project --source-dir ... --config ...) and apply via chezmoi.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 467k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |