[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79XDP3PQ404WXTYDVYGJ8H2":3,"skill-same:01M79XDP3PQ404WXTYDVYGJ8H2":61},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":30,"commitSha":31,"skillDirectory":32,"forksCount":33,"repositoryHtmlUrl":34,"repositoryHomepageUrl":6,"ownerHtmlUrl":35,"ownerBlogUrl":6,"ownerDescription":36,"updatedAt":37,"install":38,"resources":50},"01M79XDP3PQ404WXTYDVYGJ8H2","marshal",null,"Meta-orchestrator that takes any direction — broad, specific, or vague — and autonomously chains skills and context into actionable work. Gathers context from codebase, docs, and memory. Only asks the user when it genuinely cannot proceed. Single-session orchestrator.","mayankjain1815-commits\u002FCITADEL","mayankjain1815-commits","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F234472344?v=4","01M79X9599EWEQTD62DMNTEG7X","Mayank jain","01M79X95AA0KDFTN1Z1A6DQTX1",4,"MIT","https:\u002F\u002Fgithub.com\u002Fmayankjain1815-commits\u002FCITADEL\u002Fblob\u002Fmain\u002Fskills\u002Fmarshal\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: marshal\nlicense: MIT\ndescription: >-\n  Meta-orchestrator that takes any direction — broad, specific, or vague — and\n  autonomously chains skills and context into actionable work. Gathers context\n  from codebase, docs, and memory. Only asks the user when it genuinely cannot\n  proceed. Single-session orchestrator.\nuser-invocable: true\nauto-trigger: false\ntrigger_keywords:\n  - orchestrate\n  - chain skills\n  - multi-step\nlast-updated: 2026-03-20\n---\n\n# \u002Fmarshal — Session Commander\n\n## Orientation\n\nUse Marshal when the task is:\n- Multi-step but bounded (completable in one session)\n- Needs investigation before action\n- Spans multiple skills but doesn't need campaign persistence\n- Too complex for a single skill but doesn't need Archon\u002FFleet\n\n**Don't use when:** the task spans multiple sessions (use \u002Farchon); work decomposes into 3+ parallel streams (use \u002Ffleet); you only need research with no action (use \u002Fresearch).\n- Parallel execution (use Fleet)\n\n## Commands\n\n| Command | Behavior |\n|---|---|\n| `\u002Fmarshal [direction]` | Full loop: understand → plan → execute → report |\n| `\u002Fmarshal assess [area]` | Read-only: understand the area, produce findings, don't fix |\n\n## Protocol\n\n### Phase 1: UNDERSTAND\n\nParse the user's direction into structured intent:\n\n1. Read CLAUDE.md to understand the project's architecture and conventions\n2. Identify: scope (which files\u002Fdirectories), perspective (user, developer, admin),\n   mode (audit, fix, build, improve, map), depth (surface scan vs deep investigation)\n3. If the direction is ambiguous, make a reasonable interpretation and state it.\n   Do NOT ask clarifying questions unless genuinely stuck.\n\n### Phase 2: PLAN CHAIN\n\nMap the intent to a sequence of actions:\n\n| Direction Pattern | Chain |\n|---|---|\n| \"audit [area]\" | explore → analyze → report findings |\n| \"fix [thing]\" | investigate root cause → fix → verify → report |\n| \"map [area]\" | read files in parallel → synthesize → produce analysis |\n| \"improve [area]\" | audit current state → identify gaps → implement → verify |\n| \"what should [X] be\" | research → analyze options → recommend with reasoning |\n| \"research [topic]\" | search codebase + web → synthesize → report |\n\nAnnounce the chain before executing: \"I'll [step 1], then [step 2], then [step 3].\"\n\n### Phase 3: EXECUTE\n\nFor each step in the chain:\n\n1. Load the relevant skill if one exists (e.g., `\u002Freview` for audit steps)\n2. Gather context: read relevant files, check git history, search for patterns\n3. Perform the action\n4. Check the result against the plan — did it produce what was expected?\n5. If a step fails, try one alternative approach before escalating\n\n### Phase 4: REPORT\n\nProduce a structured report:\n\n```\n=== Marshal Report ===\n\nDirection: {original direction}\nScope: {what was examined}\n\nFindings:\n- {finding 1 with file:line reference}\n- {finding 2}\n\nActions Taken:\n- {what was changed, if anything}\n\nRecommendations:\n- {next steps if applicable}\n```\n\n### Phase 5: LEARN\n\nIf the investigation revealed reusable patterns or pitfalls:\n- Note them in the report\n- Suggest creating a skill if a pattern will recur: \"This pattern would\n  make a good skill. Run `\u002Fcreate-skill` to capture it.\"\n\n## Agent Timeouts\n\nWhen Marshal spawns sub-agents (e.g., for parallel investigation or delegated\nskill execution), it must enforce execution time limits. Sub-agents can hang\nindefinitely on tool calls — the circuit breaker catches failures, not hangs.\n\n### Default Timeouts\n\n| Agent Type | Default Timeout |\n|---|---|\n| Skill-level agents | 10 minutes |\n| Research agents | 15 minutes |\n\nTimeouts are configurable in `harness.json` under `agentTimeouts` (same config\nFleet uses). If an agent exceeds its timeout:\n\n1. Log the timeout in telemetry\n2. Check for partial output — extract usable findings if any\n3. Try one alternative approach (simpler prompt, reduced scope)\n4. If retry also times out, skip and note the gap in the report\n\nNever wait indefinitely. A timed-out agent's scope becomes a \"gap\" in the\nMarshal Report's Findings section.\n\n## Fringe Cases\n\n- **Direction is vague** (e.g., \"do the thing\", \"fix it\", \"make it better\"): Ask one clarifying question before proceeding. Do not attempt to guess scope on truly ambiguous input — one focused question is cheaper than executing the wrong plan.\n- **A sub-task fails on first attempt**: Retry once with a different approach (narrower scope, different tool, simpler method). If the second attempt also fails, record the blocker in the report and move on.\n- **No relevant files found for the stated scope**: Report the empty result honestly. Do not fabricate findings. Suggest the user verify the scope or file paths.\n- **CLAUDE.md missing**: Proceed without it. Note the absence in the report so the user knows project conventions weren't applied.\n- **Typecheck not configured**: Skip the verification step and note it as \"unverified\" in the report rather than blocking completion.\n\n## Quality Gates\n\n- Every finding must cite a specific file and line number\n- Every action must be verified (typecheck passes, tests pass)\n- If a fix was applied, confirm the original issue is resolved\n- The report must be concise — no filler, no repetition\n- If you're stuck on a step for more than 3 attempts, skip it and report the blocker\n\n## Exit Protocol\n\n1. Output the Marshal Report (format above)\n2. If work items were discovered but not addressed, suggest creating intake items\n3. Output a HANDOFF block summarizing what was done\n\n```\n---HANDOFF---\n- What: {behavior changed or goal achieved — not the file name, the outcome}\n- Decisions: {key tradeoffs made — include the alternative that was rejected}\n- Unresolved: {what is still open or blocked — actionable next step}\n- Reversibility: {green | amber | red} — {how to undo}\n---\n```\n","# \u002Fmarshal — Session Commander\n\n## Orientation\n\nUse Marshal when the task is:\n- Multi-step but bounded (completable in one session)\n- Needs investigation before action\n- Spans multiple skills but doesn't need campaign persistence\n- Too complex for a single skill but doesn't need Archon\u002FFleet\n\n**Don't use when:** the task spans multiple sessions (use \u002Farchon); work decomposes into 3+ parallel streams (use \u002Ffleet); you only need research with no action (use \u002Fresearch).\n- Parallel execution (use Fleet)\n\n## Commands\n\n| Command | Behavior |\n|---|---|\n| `\u002Fmarshal [direction]` | Full loop: understand → plan → execute → report |\n| `\u002Fmarshal assess [area]` | Read-only: understand the area, produce findings, don't fix |\n\n## Protocol\n\n### Phase 1: UNDERSTAND\n\nParse the user's direction into structured intent:\n\n1. Read CLAUDE.md to understand the project's architecture and conventions\n2. Identify: scope (which files\u002Fdirectories), perspective (user, developer, admin),\n   mode (audit, fix, build, improve, map), depth (surface scan vs deep investigation)\n3. If the direction is ambiguous, make a reasonable interpretation and state it.\n   Do NOT ask clarifying questions unless genuinely stuck.\n\n### Phase 2: PLAN CHAIN\n\nMap the intent to a sequence of actions:\n\n| Direction Pattern | Chain |\n|---|---|\n| \"audit [area]\" | explore → analyze → report findings |\n| \"fix [thing]\" | investigate root cause → fix → verify → report |\n| \"map [area]\" | read files in parallel → synthesize → produce analysis |\n| \"improve [area]\" | audit current state → identify gaps → implement → verify |\n| \"what should [X] be\" | research → analyze options → recommend with reasoning |\n| \"research [topic]\" | search codebase + web → synthesize → report |\n\nAnnounce the chain before executing: \"I'll [step 1], then [step 2], then [step 3].\"\n\n### Phase 3: EXECUTE\n\nFor each step in the chain:\n\n1. Load the relevant skill if one exists (e.g., `\u002Freview` for audit steps)\n2. Gather context: read relevant files, check git history, search for patterns\n3. Perform the action\n4. Check the result against the plan — did it produce what was expected?\n5. If a step fails, try one alternative approach before escalating\n\n### Phase 4: REPORT\n\nProduce a structured report:\n\n```\n=== Marshal Report ===\n\nDirection: {original direction}\nScope: {what was examined}\n\nFindings:\n- {finding 1 with file:line reference}\n- {finding 2}\n\nActions Taken:\n- {what was changed, if anything}\n\nRecommendations:\n- {next steps if applicable}\n```\n\n### Phase 5: LEARN\n\nIf the investigation revealed reusable patterns or pitfalls:\n- Note them in the report\n- Suggest creating a skill if a pattern will recur: \"This pattern would\n  make a good skill. Run `\u002Fcreate-skill` to capture it.\"\n\n## Agent Timeouts\n\nWhen Marshal spawns sub-agents (e.g., for parallel investigation or delegated\nskill execution), it must enforce execution time limits. Sub-agents can hang\nindefinitely on tool calls — the circuit breaker catches failures, not hangs.\n\n### Default Timeouts\n\n| Agent Type | Default Timeout |\n|---|---|\n| Skill-level agents | 10 minutes |\n| Research agents | 15 minutes |\n\nTimeouts are configurable in `harness.json` under `agentTimeouts` (same config\nFleet uses). If an agent exceeds its timeout:\n\n1. Log the timeout in telemetry\n2. Check for partial output — extract usable findings if any\n3. Try one alternative approach (simpler prompt, reduced scope)\n4. If retry also times out, skip and note the gap in the report\n\nNever wait indefinitely. A timed-out agent's scope becomes a \"gap\" in the\nMarshal Report's Findings section.\n\n## Fringe Cases\n\n- **Direction is vague** (e.g., \"do the thing\", \"fix it\", \"make it better\"): Ask one clarifying question before proceeding. Do not attempt to guess scope on truly ambiguous input — one focused question is cheaper than executing the wrong plan.\n- **A sub-task fails on first attempt**: Retry once with a different approach (narrower scope, different tool, simpler method). If the second attempt also fails, record the blocker in the report and move on.\n- **No relevant files found for the stated scope**: Report the empty result honestly. Do not fabricate findings. Suggest the user verify the scope or file paths.\n- **CLAUDE.md missing**: Proceed without it. Note the absence in the report so the user knows project conventions weren't applied.\n- **Typecheck not configured**: Skip the verification step and note it as \"unverified\" in the report rather than blocking completion.\n\n## Quality Gates\n\n- Every finding must cite a specific file and line number\n- Every action must be verified (typecheck passes, tests pass)\n- If a fix was applied, confirm the original issue is resolved\n- The report must be concise — no filler, no repetition\n- If you're stuck on a step for more than 3 attempts, skip it and report the blocker\n\n## Exit Protocol\n\n1. Output the Marshal Report (format above)\n2. If work items were discovered but not addressed, suggest creating intake items\n3. Output a HANDOFF block summarizing what was done\n\n```\n---HANDOFF---\n- What: {behavior changed or goal achieved — not the file name, the outcome}\n- Decisions: {key tradeoffs made — include the alternative that was rejected}\n- Unresolved: {what is still open or blocked — actionable next step}\n- Reversibility: {green | amber | red} — {how to undo}\n---\n```\n",{"name":5,"license":15,"description":7,"auto-trigger":20,"last-updated":24,"user-invocable":25,"trigger_keywords":26},1773964800000,true,[27,28,29],"orchestrate","chain skills","multi-step","main","49119fa06efc769f502bede04ad99746ac20f021","skills\u002Fmarshal",0,"https:\u002F\u002Fgithub.com\u002Fmayankjain1815-commits\u002FCITADEL","https:\u002F\u002Fgithub.com\u002Fmayankjain1815-commits","2nd-yr EEE 📍 Bangalore | Python, C, Java, C# | ML, NLP & Flask backends | Building AI tools that ship 🚀 | Open to hackathons & collabs","2026-11-14 14:46:28",{"source":8,"skillName":5,"commands":39,"prompt":49,"zipAvailable":25},[40,43,46],{"tool":41,"command":42},"npx","npx skills add mayankjain1815-commits\u002FCITADEL --skill marshal",{"tool":44,"command":45},"bunx","bunx skills add mayankjain1815-commits\u002FCITADEL --skill marshal",{"tool":47,"command":48},"pnpm","pnpm dlx skills add mayankjain1815-commits\u002FCITADEL --skill marshal","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmayankjain1815-commits\u002FCITADEL\u002Fblob\u002Fmain\u002Fskills\u002Fmarshal\u002FSKILL.md",[51,57],{"path":52,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":55,"sourceHtmlUrl":56},"__benchmarks__\u002Faudit-and-report.md","REFERENCE","参考文档",999,"https:\u002F\u002Fgithub.com\u002Fmayankjain1815-commits\u002FCITADEL\u002Fblob\u002Fmain\u002Fskills\u002Fmarshal\u002F__benchmarks__\u002Faudit-and-report.md",{"path":58,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":59,"sourceHtmlUrl":60},"__benchmarks__\u002Fvague-direction.md",948,"https:\u002F\u002Fgithub.com\u002Fmayankjain1815-commits\u002FCITADEL\u002Fblob\u002Fmain\u002Fskills\u002Fmarshal\u002F__benchmarks__\u002Fvague-direction.md",[62,69,76,83,90,97],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":19},"01M79XH1DBMXQEF9N0Q6NW7Q5P","workspace","Multi-repo campaign coordinator. Same lifecycle as fleet -- scope claims, discovery relay, wave-based execution -- but the unit of work is a repo, not a file. Coordinates campaigns across repositories with shared context.","https:\u002F\u002Fgithub.com\u002Fmayankjain1815-commits\u002FCITADEL\u002Fblob\u002Fmain\u002Fskills\u002Fworkspace\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":19},"01M79XGWJJHSKNTH78TNVX09VK","wiki","Markdown-first knowledge base where the LLM acts as librarian. Ingests raw sources, compiles and interlinks topic files, self-maintains an index. No vector DB or embeddings required -- uses LLM-native navigation over structured markdown up to ~400K words.","https:\u002F\u002Fgithub.com\u002Fmayankjain1815-commits\u002FCITADEL\u002Fblob\u002Fmain\u002Fskills\u002Fwiki\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M79XGNW2YTFHVMEZGZDEDN43","watch","File sentinel that monitors the working directory for changes and marker comments, then auto-triggers appropriate skills. Poll-based via git diff against the last scan commit. Writes intake items for batch processing and routes marker actions through \u002Fdo. Use for automatic reactions to file changes; do NOT use for one-off inspection or tasks needing human judgment per file.","https:\u002F\u002Fgithub.com\u002Fmayankjain1815-commits\u002FCITADEL\u002Fblob\u002Fmain\u002Fskills\u002Fwatch\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M79XGHZ0028HDW7SDT186D6Q","verify","Self-test the Citadel hook pipeline from within a live session. Exercises real tool calls (Write, Edit, Bash, Read) and checks that hooks fired, telemetry accumulated, and no errors occurred. Reports HOOK HEALTH: PASS or HOOK HEALTH: FAIL with a per-hook breakdown.","https:\u002F\u002Fgithub.com\u002Fmayankjain1815-commits\u002FCITADEL\u002Fblob\u002Fmain\u002Fskills\u002Fverify\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":19},"01M79XGDKHMADJXC27T0FMQAN3","unharness","Remove Citadel from a project. Exports valuable state (campaigns, postmortems, research, backlog, discoveries) to docs\u002Fcitadel\u002F as human-readable markdown, then removes all harness files and hooks. The archive is detected by \u002Fdo setup on re-install and offered for restore.","https:\u002F\u002Fgithub.com\u002Fmayankjain1815-commits\u002FCITADEL\u002Fblob\u002Fmain\u002Fskills\u002Funharness\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":19},"01M79XG81A3RHP2TKKBT5WYEY2","triage","GitHub issue and PR investigator. Pulls open issues\u002FPRs, classifies them, searches the codebase for root cause or reviews contributed code, proposes fixes with file:line references, and optionally implements fixes. Use for investigating GitHub issues and reviewing PRs; do NOT use for general code review unrelated to GitHub issues.","https:\u002F\u002Fgithub.com\u002Fmayankjain1815-commits\u002FCITADEL\u002Fblob\u002Fmain\u002Fskills\u002Ftriage\u002FSKILL.md",[],[]]