Agent skill

Ad Ground

by CorridorTech in CorridorTech/PoseCap

Four-source pre-implementation research — official docs, validated implementation references (open-source repos, Stack Overflow / forum answers, blog posts, gists), in-repo patterns, and git history…

Apache-2.0Auto-check: notesWriting & Content

Install Ad Ground

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

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

GitHub CLI
$ gh skill install CorridorTech/PoseCap ad-ground --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-ground .claude/skills/ad-ground && 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-ground
GitHub stars
220
Token cost
~2k tokens
SKILL.md length
862 words
Files
1
Skills in repo
15
Repo updated
First seen
Licence
Apache-2.0

At a glance

Four-source pre-implementation research — official docs, validated implementation references (open-source repos, Stack Overflow / forum answers, blog posts, gists), in-repo patterns, and git history…

  • Works in 5 steps: Scope the research scope → Four-source research pass (all four… → Happy path synthesis → …
  • Tasks that involve Git workflow
  • SKILL.md covers Step 0 — Scope the research…, Step 1 — Four-source research…, Step 2 — Happy path synthesis and Step 3 — Deviation gate, plus 3 more sections
  • Calls git

What it does

Ad Ground is an agent skill from CorridorTech/PoseCap. Four-source pre-implementation research — official docs, validated implementation references (open-source repos, Stack Overflow / forum answers, blog posts, gists), in-repo patterns, and git history — then synthesize a happy path and gate any deviation with an irrefutable justification before code is written. Auto-invokes on non-trivial work, refactors, library or pattern selection, "research before coding", "before implementing", "which library", "which pattern", "how to approach", "ground before coding"…

Its SKILL.md is about 2k 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 Writing & Content, covering Git workflow, Blog and article writing and Refactoring. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Git workflow
  • Tasks that involve Blog and article writing
  • Tasks that involve Refactoring

Example prompts

  • “research before coding”
  • “before implementing”
  • “which library”
  • “/ad-ground”

Requirements

  • Pre-approved tools (allowed-tools): Read, Glob, Grep, Bash, WebFetch, WebSearch

Workflow steps

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

  1. Scope the research scope
  2. Four-source research pass (all four required)
  3. Happy path synthesis
  4. Deviation gate
  5. Confidence checkpoint

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
    • Glob
    • Grep
    • Bash
    • WebFetch
    • WebSearch

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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 Ground loads about 2k tokens when it runs. Until then it costs about 178 tokens; SKILL.md has 862 words of instructions outside code blocks.

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

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, Glob, Grep, Bash, WebFetch, WebSearch

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). 862 words, ~1,954 tokens.

Download SKILL.mdSave it as .claude/skills/ad-ground/SKILL.md (or your agent's skills folder).
name
ad-ground
description
Four-source pre-implementation research — official docs, validated implementation references (open-source repos, Stack Overflow / forum answers, blog posts, gists), in-repo patterns, and git history — then synthesize a happy path and gate any deviation with an irrefutable justification before code is written. Auto-invokes on non-trivial work, refactors, library or pattern selection, "research before coding", "before implementing", "which library", "which pattern", "how to approach", "ground before coding". Workflow-operational counterpart to WORKFLOW.md §4 (Find the Happy Path) and §5 (Ground in Real Patterns); pairs with ad-philosophy (posture) and ad-review (post-implementation §10 review).
allowed-tools
Read, Glob, Grep, Bash, WebFetch, WebSearch
summary
Four-source pre-implementation research (docs / impl-refs / in-repo / git history) + happy-path synthesis + deviation gate. WORKFLOW §4 + §5.

/ad-ground

Implements WORKFLOW §4 + §5 end-to-end as a single research pass. The four sources are joined by AND, not OR — every non-trivial change runs the full research pass, then synthesizes a happy path, then justifies any deviation. Output is the input to whatever skill or freeform turn produces the implementation plan; this skill does not write code.

Step 0 — Scope the research scope

Confirm what is being researched. The research scope is the smallest verifiable surface that captures the change: a function to add, a library to pick, a pattern to apply. State it in one sentence before research starts. If the surface is broader than one sentence captures, ask the user to narrow it; broad research scopes produce diluted research.

If the change is genuinely trivial (rename, typo, one-line refactor on a tested path), skip this skill.

Step 1 — Four-source research pass (all four required)

Source A — official documentation

For each language and library in scope, cite the canonical doc URL and version. Use WebFetch to confirm the page exists and read the relevant section; use WebSearch to locate it if the URL is unknown. If neither produces a confident hit, ask the user for a known-good link rather than fabricating one. Output: bulleted citations, one per language/library, each with URL plus a one-line summary of the relevant guidance.

Source B — validated implementation references

Find ≥1 (prefer 2–3) public implementation references solving the same technical research scope with similar techniques. References include open-source repos, Stack Overflow / forum answers, blog posts, and gists — anything with citable code or an explicit code-bearing answer. The match is technical, not domain — a CRUD-app-with-auth and a CLI-with-auth both hit "auth flow", and either is valid for the auth research scope. Use WebSearch (e.g. site:github.com <research scope> language:<lang>, site:stackoverflow.com <research scope>, <library> <research scope> example) and follow up with WebFetch of the specific page. Cite <source>:<locator> — <repo>:<path>:<line-range> for repos, <URL> for Stack Overflow / forum / blog / gist — and quote the relevant block. Never paraphrase code from training memory. If search is inconclusive, ask the user for a known reference.

Source C — in-repo examples

Grep / glob the current repo for analogous patterns. Cite <file>:<line> plus a one-line description of how the existing example handles the same shape. If the codebase has no analog, state that explicitly (real signal, not a gap).

Source D — git history

Run git log --all --oneline -- <relevant-paths>, git log --all --grep=<keyword>, and a sweep of sibling active branches (git branch -a, then git log <branch> -- <paths> on those that look related). Surface any prior attempt or sibling solution — including abandoned ones — with <commit-sha> plus the touching file path and a one-line description. If the search is genuinely empty, state "no prior attempt found" — that is the valid Source D outcome when there isn't one. Narrow with --grep or -S on multi-thousand-commit repos.

Step 2 — Happy path synthesis

In one paragraph, name the most-grounded approach for the research scope and cite at least one source per Source A / B / C. Source D is included when it produced a hit; otherwise mark "no prior attempt found." The paragraph is the canonical answer the engineer would give if asked "what is the canonical, idiomatic way to solve this here?" — the question WORKFLOW.md §4 frames.

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

Step 3 — Deviation gate

If the implementation the user (or you) is about to write deviates from the synthesized happy path, write the justification before any code lands. The justification must name the specific constraint, evidence, or trade-off forcing the deviation — generic "we want it differently" is insufficient. If the justification cannot be written confidently, loop back to Step 1 and look harder; do not deviate without it.

The gate is prescriptive, not descriptive: WORKFLOW §4 asks "was the deviation deliberate?"; this gate asks "is the deviation defensible against the four sources?" Write the answer down.

Step 4 — Confidence checkpoint

Before handing off to implementation, report a soft verdict against four checks:

  • A consulted (≥1 official-doc citation per language/library)
  • B consulted (≥1 implementation-reference citation, with cite-and-fetched code)
  • C consulted (in-repo analog cited or "no analog found" stated)
  • D checked (commits / branches surveyed; hit cited or "no prior attempt found")
  • Happy path declared (Step 2)
  • Deviation, if any, justified (Step 3)

If any check fails, surface the gap to the user and ask before proceeding rather than blocking. The user retains the authority to skip; the discipline is in surfacing, not in enforcement.

When the host exposes AskUserQuestion, render the checkpoint as a structured multi-choice card listing the six checks with their yes/no/n.a. status plus a final proceed / pause for more research selector — instead of dropping the verdict as plain text. Falls back to numbered text on hosts without the primitive (Codex).

Output contract

A single message structured as:

## Recortte
<one sentence>

## Source A — official documentation
- <lang/lib>: <URL@version> — <one-line summary>

## Source B — validated implementation references
- <repo>:<path>:<line-range> — <one-line summary>   # repo form
  <quoted code block>
  ```
- <URL> — <one-line summary>                         # Stack Overflow / forum / blog / gist
  ```
  <quoted code block>
  ```

Source C — in-repo examples

  • <file>:<line> — <one-line summary>
  • (or: "no analog found in the codebase")

Source D — git history

  • <commit-sha> <touching-path> — <one-line summary>
  • (or: "no prior attempt found")

Happy path

<one paragraph synthesizing A + B + C + D, with citations>

Proposed implementation vs happy path

  • aligned: <what stays canonical>
  • deviates: <list of deviations>
    • <deviation>: <irrefutable justification>

Confidence checkpoint

  • A consulted: yes / no — <gap if no>
  • B consulted: yes / no — <gap if no>
  • C consulted: yes / no — <gap if no>
  • D checked: yes / no — <gap if no>
  • happy path declared: yes
  • deviations justified: yes / no / n.a.

No code is written by this skill. The output feeds the next turn (or `/ad-task`, `/ad-philosophy`'s Goal-Driven Execution, or freeform implementation).

## Next

- Implement per the synthesized happy path. Cite the sources you grounded against in commit messages or task `Notes`.
- `/ad-task` if the work needs explicit decomposition into checkbox-toggle work units.
- `/ad-review main..HEAD` (or current scope) before merge — WORKFLOW §10.
- `/ad-adr` if the deviation gate surfaced a binding architectural decision.

© 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-ground of CorridorTech/PoseCap.

Open the folder on GitHubat commit 626701b

Compare with similar skills

Ad Ground 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 Ground compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ad Ground this skillCorridorTech/PoseCap220—~2kAutomated safety check: NotesApache-2.0
Ad Groundalexandremendoncaalvaro/CorridorKey-Runtime7551 repos~1.5kAutomated safety check: PassCustom licence
SepiaNanako0129/sepia3k—~3.6kAutomated safety check: PassMIT
Blogtheopenco/llmgateway1.7k—~2.2kAutomated safety check: PassCustom licence
Release Postquarto-dev/quarto-r1601 repos~2.5kAutomated safety check: PassMIT
Penguin Harness DevPrism-Shadow/penguin-harness2.5k—~3.4kAutomated safety check: PassApache-2.0

Similar skills

  • Ad Ground

    alexandremendoncaalvaro/CorridorKey-Runtime

    Four-source pre-implementation research — official docs, validated implementation references (open-source repos, Stack Overflow / forum answers, blog posts, gists), in-repo patterns, and git history…

    755 GitHub starsUsed in 1 repo~1.5k tokens
    Writing & ContentAuto-check passed
  • Sepia

    Nanako0129/sepia

    Make AI-generated writing read as human-written, in fiction and in professional prose.

    3k GitHub stars~3.6k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Blog

    theopenco/llmgateway

    Write and validate an LLM Gateway marketing blog post in the repository's current house style, including structured frontmatter and a gpt-image-2 OpenGraph image.

    1.7k GitHub stars~2.2k tokensUpdated today
    Writing & ContentAuto-check passed
  • Release Post

    quarto-dev/quarto-r

    Create professional package release blog posts following Tidyverse or Shiny blog conventions.

    160 GitHub starsUsed in 1 repo~2.5k tokens
    Writing & ContentAuto-check passed
  • Penguin Harness Dev

    Prism-Shadow/penguin-harness

    A skill your agent uses when developing PenguinHarness itself — changing packages/{core,server,web,cli,desktop,landing,docs,skills}, the built-in model catalog, the installers or the release…

    2.5k GitHub stars~3.4k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Create Release Blog

    web-infra-dev/rstest

    Generate a narrative version release blog post from commits within a tag range.

    505 GitHub stars~4.7k tokensUpdated 7 days ago
    Writing & ContentAuto-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.

    220 GitHub stars~1k tokensUpdated today
    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.

    220 GitHub stars~1.5k tokensUpdated today
    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.

    220 GitHub stars~1.9k tokensUpdated today
    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.

    220 GitHub stars~1.8k tokensUpdated today
    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).

    220 GitHub stars~2.4k tokensUpdated today
    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.

    220 GitHub stars~3.3k tokensUpdated today
    Auto-check: notes

Questions about Ad Ground

What does Ad Ground do?

Four-source pre-implementation research — official docs, validated implementation references (open-source repos, Stack Overflow / forum answers, blog posts, gists), in-repo patterns, and git history…. Ad Ground is an agent skill from CorridorTech/PoseCap. Four-source pre-implementation research — official docs, validated implementation references (open-source repos, Stack Overflow / forum answers, blog posts, gists), in-repo patterns, and git history — then synthesize a happy path and gate any deviation with an irrefutable justification before code is written.

When should I use Ad Ground?

Ad Ground fits situations like: tasks that involve Git workflow; tasks that involve Blog and article writing; tasks that involve Refactoring.

How do I install Ad Ground in Claude Code?

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

How do I install Ad Ground in Codex?

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

Can I use Ad Ground 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-ground -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-ground, .gemini/skills/ad-ground, .github/skills/ad-ground and .opencode/skills/ad-ground in your project.

What does Ad Ground need to run?

Going by SKILL.md and its folder, Ad Ground needs the command-line tools its instructions call (git). Its frontmatter pre-approves these tools: Read, Glob, Grep, Bash, WebFetch, WebSearch.

Does Ad Ground access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Ad Ground 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 Ground use?

Ad Ground 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 Ground use?

About 2k tokens (SKILL.md is roughly 7.8k 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 Ground?

Skills that share tags, products or a category with Ad Ground: Ad Ground (alexandremendoncaalvaro/CorridorKey-Runtime, 755 stars), Sepia (Nanako0129/sepia, 3k stars), Blog (theopenco/llmgateway, 1.7k stars) and Release Post (quarto-dev/quarto-r, 160 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ad Ground?

CorridorTech (a GitHub organization) maintains it in CorridorTech/PoseCap, which has 220 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.