mcpField
B
box

box

github.com/prathamdbyDevelopment6630 installsUpdated 5d ago
Repository

About box

A skill for cloning or searching local repositories and reporting findings, with persistence only when requested. It defines separate preparation, search, and write responsibilities, and keeps sandboxes outside the working repository.

Key features

  1. 01Clone repositories when needed
  2. 02List existing clones
  3. 03Search local files with evidence
  4. 04Separate delegated work by scope
  5. 05Persist to AGENTS.md when requested

Use cases

  1. 01Find information across a cloned repository
  2. 02List clones and identify stale copies
  3. 03Save approved findings to the working repo's AGENTS.md

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/prathamdby/skills --skill box

After installing, type/boxin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

REFERENCE.md
references/
agents-md-template.md
persist.md
prepare.md

Details

From the project README

Box

Options and ownership

Default clone-if-needed/search/report; persist only when asked. "Update"/"pull first" fast-forwards first; "list" reports clones and stops. "Persist"/"add to AGENTS.md" enables that write after search. "No subagents"/"in this thread", or unavailable delegation, selects Direct; otherwise Delegated. Keep this explicit mode switch, not a size heuristic. Conflicting list/search or missing needed URL blocks.

Resolve this skill's absolute anchor, sandbox/manifest.json, sandbox/, and working repo/AGENTS.md. Sandboxes stay outside the working repo. Direct executes stage contracts. Delegated uses one Prepare writer, disjoint read-only Search workers, one Persist writer; parent only dispatches/aggregates. A failed worker blocks; workers cannot delegate. Record mode | slug/URL/path | prepare | search scopes/evidence | persist | current | terminal.

1. Detect and prepare

Bare/list: missing manifest is empty; report slug, URL, path and stale clones, then stop. URL slug is final segment without .git; names match case-sensitively. Zero/multiple matches need a URL. Done when list is sent or identity fixed.

For search, run/dispatch references/prepare.md with absolute inputs. Wait for validation before search. A partial clone never enters the manifest; unknown directories are not deleted. Done when clone origin and manifest match.

2. Search

Assign non-overlapping subtrees/questions with absolute clone paths. Search local files only, read-only; no question means README/manifests/layout/entries. Require path:line evidence or a scoped no-match, surrounding context, and omissions. Briefs include anchor, identity, stage, write boundary, inputs, outputs, and no nested delegation. Done when every scope returns evidence.

3. Aggregate and persist

Answer by theme with deduplicated citations and unsearched areas. Only when persist was requested and search is complete, run/dispatch references/persist.md; its only target is the working repo's AGENTS.md. Done when answer is cited and any authorized marker block exists exactly once.

On resume verify manifest/clone/results/markers; restart the earliest unfinished condition, redispatch missing searches. Report identity/path, preparation, scopes/no-matches, persist. SUCCESS/BLOCKED/NO_MATCHES (all scopes empty). No clone commits/pushes, URL-based guesses, or overlapping write ownership.

Comments

Markdown supported