Skip to content

fmind/agent-supagents / skills/supagent

supagent

Unverified

Compile 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

  1. Inspect existing sources, generated outputs, Git status, and installed harness versions; preserve handwritten profiles and unrelated work.
  2. Pick project (.agents/supagents/) or global (~/.agents/supagents/) scope, then scaffold only active harnesses:
    supagents init NAME --project --target claude --target codex
    
  3. 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.
  4. Preview diffs and mappings without writing:
    supagents build --project --diff
    
    Pass --source-dir PATH --config FILE consistently for custom or chezmoi layouts.
  5. Compile and verify strictly with zero warnings, errors, drift, or obsolete files:
    supagents build --project --strict
    supagents check --project --strict
    
  6. Verify native discovery in each installed host separately from compilation and bounded runtime runs.

Native Formats

  • AGY, CLAUDE, COPILOT, CURSOR, GEMINI, GROK, KILO, and OPENCODE emit Markdown with merged YAML frontmatter.
  • CODEX emits TOML (name and description required) and stores the body plus APPEND_BODY in developer_instructions.
  • OUTPUT overrides an output path (relative paths resolve beside the source); custom targets in config can set format: toml and body_key.
  • Shared _*.md partials in the source directory factor repeated target settings and body slots ({{BODY}}) via extends: _name or extends: [_a, _b]; TARGET: false disables 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-run before authorized supagents 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.
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: 467kUpdated Claude CodeCodexVerifiedInstall
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: 319kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 319kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 319kUpdated Claude CodeCodexVerifiedInstall