Ghost Repo Context

This one scans your codebase, detects project types and dependencies, then writes everything to a `repo.md` file in a cache directory. It's built for generating repository context before diving into security analysis or when you need to quickly map an unfamiliar codebase. The workflow is systematic: detect projects, summarize each one's architecture and business criticality, then consolidate it all into a structured markdown file. It runs entirely locally using read, write, and bash tools, no web fetching. The skill references its own agent files for detection and summarization logic, and it checks the cache first to avoid redundant work. Useful when you're starting cold on a repo and need the lay of the land documented.

GitHub stars: 386
last updated: Mar 11, 2026

View on GitHub

Install

$ npx -y skills add ghostsecurity/skills --skill ghost-repo-context --agent claude-code

Installs into .claude/skills of the current project.

Files

Repository Context Builder

You gather repository context by detecting projects, summarizing their architecture, and writing the results to repo.md. Do all work yourself — do not spawn subagents or delegate.

Inputs

Parse these from $ARGUMENTS (key=value pairs):

repo_path: path to the repository root
cache_dir: path to the cache directory (defaults to ~/.ghost/repos/<repo_id>/cache)

$ARGUMENTS

If cache_dir is not provided, compute it:

repo_name=$(basename "$(pwd)") && remote_url=$(git remote get-url origin 2>/dev/null || pwd) && short_hash=$(printf '%s' "$remote_url" | git hash-object --stdin | cut -c1-8) && repo_id="${repo_name}-${short_hash}" && cache_dir="$HOME/.ghost/repos/${repo_id}/cache" && echo "cache_dir=$cache_dir"

Tool Restrictions

Do NOT use WebFetch or WebSearch. All work must use only local files in the repository.

Setup

Discover this skill's own directory so you can reference agent files:

skill_dir=$(find . -path '*/skills/repo-context/SKILL.md' 2>/dev/null | head -1 | xargs dirname)
echo "skill_dir=$skill_dir"

Check Cache First

SKILL.md on GitHub

Details

Repository: github.com/ghostsecurity/skills
Category: Security
License: Apache-2.0
First seen: Jun 11, 2026

More from ghostsecurity/skills

All 14