Agent skill

Ad Subagent

by CorridorTech in CorridorTech/PoseCap

Draft a new Claude Code subagent at .claude/agents/<name.md, using the official subagents format.

Apache-2.0Auto-check: notesAgent Workflows

Install Ad Subagent

skills CLI
$ npx skills add CorridorTech/PoseCap --skill ad-subagent -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install CorridorTech/PoseCap ad-subagent --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/CorridorTech/PoseCap.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/ad-subagent .claude/skills/ad-subagent && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ad-subagent
GitHub stars
224
Token cost
~1.3k tokens
SKILL.md length
586 words
Files
1
Skills in repo
15
Repo updated
First seen
Licence
Apache-2.0

At a glance

Draft a new Claude Code subagent at .claude/agents/<name.md, using the official subagents format.

  • Works in 5 steps: Confirm target → Pick a pattern (or build custom) → Interview to fill → …
  • The user wants to create
  • SKILL.md covers Step 1 — Confirm target, Step 2 — Pick a pattern (or…, Step 3 — Interview to fill and Step 4 — Write the file, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Ad Subagent is an agent skill from CorridorTech/PoseCap. Draft a new Claude Code subagent at .claude/agents/<name.md, using the official subagents format. Use when the user wants to create, write, draft, or scaffold a custom Claude Code subagent for delegated work (fresh-context reviewer, codebase researcher, docs researcher, test designer, bug reproducer, bounded implementation worker). Asks one question per missing field; never invents roles or tool sets.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Subagents. It works with Bash. The licence is Apache-2.0.

When your agent uses it

  • The user wants to create
  • Scaffold a custom Claude Code subagent for delegated work (fresh-context reviewer
  • Codebase researcher
  • Docs researcher

Example prompts

  • “/ad-subagent”

Requirements

  • Pre-approved tools (allowed-tools): Read, Write, Glob, Bash

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Confirm target
  2. Pick a pattern (or build custom)
  3. Interview to fill
  4. Write the file
  5. Stop after writing

What it can do on your machine

Read from SKILL.md and the folder at commit 626701b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Glob
    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • code.claude.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ad Subagent loads about 1.3k tokens when it runs. Until then it costs about 104 tokens; SKILL.md has 586 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~104
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Write, Glob, Bash

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from CorridorTech/PoseCap at commit 626701b, republished under its Apache-2.0 licence (© CorridorTech). 586 words, ~1,279 tokens.

Download SKILL.mdSave it as .claude/skills/ad-subagent/SKILL.md (or your agent's skills folder).
name
ad-subagent
description
Draft a new Claude Code subagent at .claude/agents/<name>.md, using the official subagents format. Use when the user wants to create, write, draft, or scaffold a custom Claude Code subagent for delegated work (fresh-context reviewer, codebase researcher, docs researcher, test designer, bug reproducer, bounded implementation worker). Asks one question per missing field; never invents roles or tool sets.
allowed-tools
Read, Write, Glob, Bash
summary
Draft a host-specific custom subagent for bounded delegated work — Claude Code `.claude/agents/<name>.md`, Codex `.codex/agents/<name>.toml`.

/ad-subagent

Drafts .claude/agents/<name>.md (project) or ~/.claude/agents/<name>.md (personal). Spec: code.claude.com/docs/en/sub-agents.

The body becomes the subagent's role prompt. A named subagent starts with fresh conversation context and its own tools/model settings; do not rely on parent-session memory. Restate task-specific constraints and cite any project files it must follow.

Step 1 — Confirm target

Ask the user:

  • Name — kebab-case, lowercase. Becomes the file name and the routing handle (subagent_type: '<name>').
  • Personal or project — ~/.claude/agents/<name>.md (personal) vs .claude/agents/<name>.md (project, committed). Default: project.

Step 2 — Pick a pattern (or build custom)

Common pre-baked shapes (from prompts/subagent.md):

PatternToolsModelNotes
Fresh-context reviewerRead, Glob, Grep, BashsonnetMatches WORKFLOW §10. No write tools.
Codebase researcheruse built-in ExploreinheritDon't build custom unless you need different tools.
Diff-only auditorRead, BashsonnetPair with permissionMode: dontAsk for read-only runs.
Docs researcherRead, WebFetch or docs MCPinheritConfirms versioned APIs; returns citations only.
Test designerRead, Glob, GrepinheritProposes public-interface tests from spec/task; no production edits.
Bug reproducerRead, Bash, WriteinheritBuilds the smallest failing loop, then stops before broad fixes.
Bounded workerscoped write toolsinheritOwns a disjoint file/module set; returns changed paths + verification.

Built-in subagents (Explore, Plan, general-purpose) cover most cases. Build custom only when you need a specific role, scoped tools, persistent memory, or a different model.

Delegation-fit gate: build a custom subagent only when the role repeats, the work is self-contained, the output can be summarized or bounded to a disjoint patch, or the role needs tool/model/sandbox restrictions. Keep frequent back-and-forth, tightly coupled implementation, and the immediate blocking step in the main conversation.

Step 3 — Interview to fill

Ask one question per missing field, in this order:

  • Role — one sentence: "You are a <role> that <does X> when <triggered by Y>."
  • Description — the routing signal. Specific, includes the task framings the parent agent would recognize. Claude reads this to decide whether to delegate.
  • Tools — comma-separated list. Limit deliberately. A reviewer with Write access stops being a reviewer. Omit to inherit all parent tools.
  • Model — sonnet | opus | haiku | inherit. Default: inherit.
  • Output contract — what the subagent returns to the caller. Be explicit about format.
  • Stop criterion — when the subagent should stop and return control.

Do not invent values. When the user does not know something, ask. Do not invent frontmatter fields not in the spec.

Show full SKILL.md (201 more words)Show less

Step 4 — Write the file

Path: .claude/agents/<name>.md (project, committed) or ~/.claude/agents/<name>.md (personal). Frontmatter uses the Claude Code subagents shape (see code.claude.com/docs/en/sub-agents) — declare only the fields the subagent actually uses.

Body = the role prompt. Every line costs tokens on every subagent turn. Be terse. State role, scope, output format, stop criterion, and what NOT to do. Restate task-specific constraints and point to project files for load-bearing conventions.

Edits to subagent files on disk require a session restart to take effect; agents created via Claude Code's /agents UI take effect immediately.

Step 5 — Stop after writing

Do not dispatch to the new subagent, do not test it. The user will exercise it themselves.

Output contract

A single new file at .claude/agents/<name>.md (or ~/.claude/agents/<name>.md). Frontmatter declares only the fields actually used. Body is the system prompt: terse, imperative, with explicit stop criterion. No external file dependencies the user did not ask for.

Next

  • Test the new subagent by exercising the workflow it serves — invoke via the Task tool with subagent_type: '<name>'.
  • Document the subagent in AGENTS.md (or the project's operational guide) if it is project-wide rather than personal.
  • If the subagent ships alongside a skill (manifest-listed), update the skill's manifest.json to declare the file.

© CorridorTech, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/ad-subagent of CorridorTech/PoseCap.

Open the folder on GitHubat commit 626701b

Compare with similar skills

Ad Subagent next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ad Subagent compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ad Subagent this skillCorridorTech/PoseCap224—~1.3kAutomated safety check: NotesApache-2.0
Kimi Code DelegationCherryHQ/cherry-studio52k1 repos~504Automated safety check: PassAGPL-3.0
Teamethanhq/cc-fleet2151 repos~3.4kAutomated safety check: PassApache-2.0
Subagentethanhq/cc-fleet215—~4.3kAutomated safety check: PassApache-2.0
Agent Factoryalirezarezvani/claude-code-skill-factory8801 repos~2kAutomated safety check: PassMIT
Workflowethanhq/cc-fleet215—~5.3kAutomated safety check: PassApache-2.0

Similar skills

  • Kimi Code Delegation

    CherryHQ/cherry-studio

    Delegates one bounded repository task to Kimi Code in non-interactive prompt mode and reads back the final result from its JSON event stream.

    52k GitHub starsUsed in 1 repo~504 tokens
    Agent WorkflowsAuto-check passed
  • Team

    ethanhq/cc-fleet

    Spawn long-lived provider LLM teammates in tmux panes that you message via the native agent-team tools — multi-turn, collaborative, watchable.

    215 GitHub starsUsed in 1 repo~3.4k tokens
    Agent WorkflowsAuto-check passed
  • Subagent

    ethanhq/cc-fleet

    Run a one-shot or flat parallel batch of provider LLM subagents (headless cc-fleet subagent) that return a result.

    215 GitHub stars~4.3k tokensUpdated 8 days ago
    Agent WorkflowsAuto-check passed
  • Agent Factory

    alirezarezvani/claude-code-skill-factory

    Claude Code agent generation system that creates custom agents and sub-agents with enhanced YAML frontmatter, tool access patterns, and MCP integration support following proven production patterns

    880 GitHub starsUsed in 1 repo~2k tokens
    Agent WorkflowsAuto-check passed
  • Workflow

    ethanhq/cc-fleet

    Orchestrate a MULTI-PHASE, dependent, or resumable run over many provider subagents from a JS script, off the main context (cc-fleet workflow).

    215 GitHub stars~5.3k tokensUpdated 8 days ago
    Agent WorkflowsAuto-check passed
  • Official

    How and when to delegate work to subagents via the subagent tool (Explore, Plan, General).

    179 GitHub stars~1.5k tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed

More from CorridorTech/PoseCap

All 15 skills in this repo
  • Ad Adr

    CorridorTech/PoseCap

    Draft a new ADR (Architecture Decision Record) at doc/adr/NNNN-<short-title.md, using Michael Nygard's Context/Decision/Consequences/Alternatives pattern.

    224 GitHub stars~1k tokensUpdated yesterday
    Auto-check: notes
  • Ad Architecture

    CorridorTech/PoseCap

    Generate ARCHITECTURE.md at the repo root by scanning the code first, pre-filling layers/patterns/observability/deployment from observed signals, then asking only the genuine gaps.

    224 GitHub stars~1.5k tokensUpdated yesterday
    Auto-check: notes
  • Ad Archive

    CorridorTech/PoseCap

    Hard-delete completed plan files (tasks Status:done, specs Status:shipped, PRDs Status:superseded, ADRs Status:superseded or deprecated) via git rm, leaving git history as the only ledger.

    224 GitHub stars~1.9k tokensUpdated yesterday
    Auto-check: notes
  • Ad Drift

    CorridorTech/PoseCap

    Read-only drift audit — compare AGENTS.md, ARCHITECTURE.md, ADR statuses, feature specs in doc/specs/, and documentation discipline against what the code actually does.

    224 GitHub stars~1.8k tokensUpdated yesterday
    Auto-check: notes
  • Ad Hooks

    CorridorTech/PoseCap

    Scaffold deterministic quality gates per WORKFLOW.md §11 — pre-commit (lint, format, secret-scan), pre-push (build, unit, integration).

    224 GitHub stars~2.4k tokensUpdated yesterday
    Auto-check: notes
  • Ad Next

    CorridorTech/PoseCap

    Survey the project's state across the six-layer artifact stack and recommend prioritized next actions, modeled on flutter doctor.

    224 GitHub stars~3.3k tokensUpdated yesterday
    Auto-check: notes

Works with

Categories

Questions about Ad Subagent

What does Ad Subagent do?

Draft a new Claude Code subagent at .claude/agents/<name.md, using the official subagents format. Ad Subagent is an agent skill from CorridorTech/PoseCap.md, using the official subagents format.

When should I use Ad Subagent?

Ad Subagent fits situations like: the user wants to create; scaffold a custom Claude Code subagent for delegated work (fresh-context reviewer; codebase researcher; docs researcher.

How do I install Ad Subagent in Claude Code?

Run `npx skills add CorridorTech/PoseCap --skill ad-subagent -a claude-code`. Or copy the skill folder (.claude/skills/ad-subagent in CorridorTech/PoseCap) into .claude/skills/ad-subagent in your project. Claude Code loads it when a task matches its description.

How do I install Ad Subagent in Codex?

Run `npx skills add CorridorTech/PoseCap --skill ad-subagent -a codex`. Or copy the skill folder (.claude/skills/ad-subagent in CorridorTech/PoseCap) into .agents/skills/ad-subagent in your project. Codex loads it when a task matches its description.

Can I use Ad Subagent in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add CorridorTech/PoseCap --skill ad-subagent -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ad-subagent, .gemini/skills/ad-subagent, .github/skills/ad-subagent and .opencode/skills/ad-subagent in your project.

What does Ad Subagent need to run?

SKILL.md names no scripts, command-line tools or credentials: Ad Subagent is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Write, Glob, Bash.

Does Ad Subagent access the network?

SKILL.md names 1 domain. As links in the text: code.claude.com. This is read from the text; nothing was executed.

Is Ad Subagent safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Ad Subagent use?

Ad Subagent is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ad Subagent use?

About 1.3k tokens (SKILL.md is roughly 5.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Ad Subagent?

Skills that share tags, products or a category with Ad Subagent: Kimi Code Delegation (CherryHQ/cherry-studio, 52k stars), Team (ethanhq/cc-fleet, 215 stars), Subagent (ethanhq/cc-fleet, 215 stars) and Agent Factory (alirezarezvani/claude-code-skill-factory, 880 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ad Subagent?

CorridorTech (a GitHub organization) maintains it in CorridorTech/PoseCap, which has 224 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on October 7, 2026.

Source: CorridorTech/PoseCap on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.