skills.rest
gmackie
gmackieCOMMUNITY
Explore all skills by this author →
Website𝕏@grahammackieGitHub

local-agent-context-discovery

Scans local repos and agent directories for plans, docs, reviews, and skill files.

Updated Mar 27, 2026
Search Tags:#documentation#local search#bash#agent workflow#triage#context discovery#repo scanning
One-click install
npx skills add https://github.com/gmackie/agent-skills --skill local-agent-context-discovery-gmackie
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: local-agent-context-discovery
Source: https://github.com/gmackie/agent-skills/tree/main/skills/local-agent-context-discovery
Command: npx skills add https://github.com/gmackie/agent-skills --skill local-agent-context-discovery-gmackie

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bash, findutils, jq, and includes scripts (resource) components.

What problem does it solve? Agents often ask users to paste files or paths when the relevant context already exists on disk. This Skill discovers plans, design notes, reviews, TODOs, and skill artifacts across the current repo, sibling repos, and local Claude or Codex directories so workflows start from real project evidence. ## Core Features & Use Cases - Prioritized local search: Scans the current repo first, then sibling working repos, then ~/.claude and ~/.codex for high-signal files like PLAN, DESIGN, REVIEW, TODO, SKILL.md, and AGENTS.md. - Bundled discovery helper: A bash script emits tab-separated or JSON-lines output listing source and absolute path for each discovered file. - Triage guidance: Instructs agents to read only the smallest useful set of files and to ask the user for input only after local discovery fails. - Use Case: When asked to summarize emerging patterns from recent work, run the helper against the current repo, inspect the top design and review artifacts, and expand to home directories only if needed. ## Quick Start Ask the agent to discover relevant local context for the current repository before requesting any pasted files or paths.

Frequently Asked Questions about local-agent-context-discovery

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find relevant project context files on my local machine?▼

Run the bundled discover-local-agent-context.sh script with a repo path to scan for PLAN, DESIGN, REVIEW, TODO, SKILL.md, and AGENTS.md files. It searches the current repo, sibling repos, and ~/.claude and ~/.codex, returning source and absolute path per result.

How to get machine-readable output from local context discovery?▼

Pass --format json to the discovery script to emit JSON lines with source and path fields per file. The default output is tab-separated text suitable for quick human review.

What directories does local agent context discovery search?▼

It searches the current repository first, then sibling repos such as smol-agent, tiered-router, and nix-config, followed by ~/.claude and ~/.codex. Missing directories are skipped silently.

Does this skill analyze the files it finds?▼

No, it only builds the search surface by locating high-signal files. Deep analysis is left to later skills or workflows, and the skill recommends triaging results before reading anything in depth.

When should I ask the user for files instead of searching locally?▼

Ask for pasted files only when local discovery is clearly insufficient, the relevant repo or directory is not present on the machine, or the needed source is external. Local search should always come first.

Related Skills

Explore More Software Engineering Skills→
kwannoelkwannoel
13

the-controller-synchronizing-skills

Synchronize Git repository skill directories to agent home directories via symbolic links.

Community
Basic
sirkirbysirkirby
62

research-synthesis

Synthesize research findings into structured markdown files for OAK planning.

Community
Basic
openyakopenyak
704

update

Syncs tasks from project trackers into TASKS.md and fills memory gaps.

Official
Intermediate
lorehqlorehq

lore-semantic-search

Enable semantic search over knowledge bases via MCP or HTTP endpoints.

Official
Intermediate