gather-context

Scan a codebase to produce a concise contextual summary in chat.

1|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/justincordova/agents --skill gather-context-justincordova
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gather-context
Source: https://github.com/justincordova/agents/tree/main/skills/gather-context
Command: npx skills add https://github.com/justincordova/agents --skill gather-context-justincordova

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly understand a codebase by scanning its structure, conventions, dependencies, and patterns. The output is a concise summary delivered in chat — no files created.

Core Features & Use Cases

  • Scan project identity: identify language, framework, runtime, and read README/SPEC.md for context.
  • Map structure: enumerate top-level directories/files and entry points to understand project layout.
  • Read conventions & dependencies: infer coding patterns, linters, and key libraries from config files.
  • Quick summary for unfamiliar projects: prepare a concise overview to speed up onboarding.
  • Use Case: When joining a new codebase, run this skill to get a crisp project snapshot in chat.

Quick Start

Run the gather-context skill on a target repository to receive a concise, chat-ready summary.

Frequently Asked Questions about gather-context

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

FAQPage Schema
How do I quickly understand an unfamiliar codebase?

To quickly understand an unfamiliar codebase, you can scan its project identity, structure, commands, and dependencies to produce a concise contextual summary. This process reads files like README.md or SPEC.md to answer quick-start questions without creating any new files.

What is the best way to map out project structure and conventions?

Mapping project structure and conventions involves enumerating top-level directories, entry points, and config files to infer coding patterns and key libraries. This approach reads documentation and configuration to deliver a chat-ready snapshot of the project layout.

Can I scan a repository to identify dependencies and commands without creating files?

Yes, you can scan a repository to identify dependencies and commands without creating files. The scanning process reads configuration files and README documentation to extract libraries, linters, and commands, delivering the entire summary directly in chat.

How does reading README and SPEC files help with onboarding to a new codebase?

Reading README and SPEC files helps with onboarding by extracting project identity, framework details, and runtime requirements. This documentation provides the context needed to infer conventions and recent activity, resulting in a crisp project snapshot for quick onboarding.

Does this codebase summary approach work for identifying coding patterns and linters?

Yes, this codebase summary approach works for identifying coding patterns and linters by reading configuration files. It infers conventions and key libraries directly from project setup files to inform a concise overview of the codebase's technical stack.

When should I not use a chat-based codebase summary?

You should not use a chat-based codebase summary when you need persistent documentation files or detailed line-by-line code analysis. This approach provides a high-level contextual overview of structure and dependencies rather than generating persistent reference files.