agentleFS
tim-mcdonnelltim-mcdonnell/skills/dig/SKILL.md

dig

Skill0 starsChanged 4 months agoMITView on GitHub

Dig into source code for ground-truth answers by cloning the relevant codebases into a shared cache and reading them. Use when the user asks how a project actually implements something, whether an integration or extension is feasible (could X be a backend or provider for Y), or says to dig into or read the source of a codebase.

6 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

6 rules. 0 are common, 5 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 4 edited versions we read keep these.

  • 5

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    All clones live in ~/.cache/dig/<org>__<repo>.

    line 11
  2. Distinctive:

    Never clone into the current project or a sibling directory.

    line 12
  3. Distinctive:

    Delete clones last used more than 7 days ago (directory mtime) without asking.

    line 14
  4. Distinctive:

    Leave clones in place when done.

    line 20
  5. Distinctive:

    When several repos or questions are in play, fan out one read-only subagent per repo-and-question.

    line 25
  6. Distinctive:

    Write the findings to a single Markdown file, citing each claim as path:line at the recorded commit.

    line 31

“Common” is measured: kept by at least 6 in 10 of the 4 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Answer from ground truth: the source code itself, at a known commit - not docs, search results, or write-ups. A question about what is possible is answered by what the code allows - an interface to implement, a plugin seam, an existing provider to pattern-match against - not by whether anyone has done it yet.

The clone cache

All clones live in ~/.cache/dig/<org>__<repo>. Never clone into the current project or a sibling directory.

  1. Delete clones last used more than 7 days ago (directory mtime) without asking; they are only cache.
  2. For each codebase the question touches, reuse the cached clone if present; otherwise git clone --filter=blob:none into the cache. Resolve the canonical repo URL yourself when only given a project name.
  3. Fetch and fast-forward each clone, then touch its directory. Record the HEAD commit - citations depend on it.

Leave clones in place when done; follow-up questions reuse them.

Digging

Restate each question as what must be true in the code for the answer to be yes, then go verify exactly that. When several repos or questions are in play, fan out one read-only subagent per repo-and-question; each returns findings with file:line citations.

Done means every claim cites file:line at the recorded commit, and every feasibility answer names the concrete seam - interface, hook, config point - or shows why none exists.

Findings

Write the findings to a single Markdown file, citing each claim as path:line at the recorded commit. Save it where the repo already keeps such notes; if there is no convention, put it somewhere sensible and say where. Then summarize the answer in chat.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.