richfrem

create-sub-agent

Interactive initialization script that generates a compliant Sub-Agent configuration. Use when you need to create a nested contextual boundary with specific tools or persistent memory.

richfrem 4 Updated 3mo ago

Resources

2
GitHub

Install

npx skillscat add richfrem/project-sanctuary/create-sub-agent

Install via the SkillsCat registry.

SKILL.md

Sub-Agent Scaffold Generator

You are tasked with generating a new Sub-Agent context boundary using our deterministic backend scaffolding pipeline.

Execution Steps:

  1. Gather Requirements:
    Before proceeding, you MUST read:

    • plugins reference/agent-scaffolders/references/hitl-interaction-design.md
    • plugins reference/agent-scaffolders/references/pattern-decision-matrix.md

    Use these guides to ask the user for:

    • The name of the sub-agent.
    • The core purpose (to form the description and system prompt).
    • The escalation risk: does this agent need an Escalation Trigger Taxonomy explicitly defined in its prompt?
    • The trust posture: warn the user that all sub-agent return boundaries MUST end in a Source Transparency Declaration (Sources Checked/Unavailable).
    • Where the agent should be placed (.claude/skills/ or within a plugin's /agents/ folder).
  2. Scaffold the Sub-Agent:
    You must execute the hidden deterministic scaffold.py script.

    Run the following bash command:

    python3 ~~agent-scaffolders-root/scripts/scaffold.py --type sub-agent --name <requested-name> --path <destination-directory> --desc "<core-purpose>"
  3. Confirmation:
    Print a success message and advise the user on how to spawn the sub-agent (usually via the System Task tool).

Next Actions

  • Offer to run audit-plugin to validate the generated artifacts.