mcpField
R
repo-intel

repo-intel

github.com/agent-shDevelopment1.0k64 installsUpdated 2d ago
Repository

About repo-intel

repo-intel is an agent skill for static repository analysis, combining git history, AST symbol mapping, and project metadata. It supports initialization, incremental updates, queries, and staleness checks, with output validation after data generation.

Key features

  1. 01Git history analysis
  2. 02AST symbol mapping
  3. 03Project metadata collection
  4. 04Incremental data updates
  5. 05Staleness checks and validation

Use cases

  1. 01Find repository hotspots
  2. 02Update repository analysis data
  3. 03Check analysis data freshness

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/agent-sh/agentsys --skill repo-intel

After installing, type/repo-intelin Claude Code to confirm it loaded.

Details

From the project README

Repo Intel Skill

Unified static analysis - git history intelligence, AST symbol mapping, and project metadata via agent-analyzer.

Parse Arguments

const args = '$ARGUMENTS'.split(' ').filter(Boolean);
const action = args.find(a => !a.startsWith('--')) || 'status';
const force = args.includes('--force');

Primary Responsibilities

  1. Initialize on demand (/repo-intel init)
  2. Update incrementally (/repo-intel update)
  3. Query git history data (/repo-intel query hotspots)
  4. Check status and staleness (/repo-intel status)
  5. Validate output with the map-validator agent

Core Data Contract

Repo intel data is stored in the platform state directory:

  • Claude Code: .claude/repo-intel.json, .claude/repo-map.json
  • OpenCode: .opencode/repo-intel.json, .opencode/repo-map.json
  • Codex CLI: .codex/repo-intel.json, .codex/repo-map.json

Behavior Rules

  • Never install dependencies without explicit user consent
  • Always validate output with map-validator after init/update
  • Prefer incremental update unless data is stale or history rewritten

When to Suggest Repo Intel

If a user asks for drift detection, documentation alignment, or repo analysis and repo-intel data is missing:

Repo intel data not found. For better analysis, run:
  /repo-intel init

Staleness Signals

  • Data commit not found (rebased)
  • Branch changed
  • Git hooks marked stale
  • Commits behind HEAD

Output Expectations

Keep outputs concise:

  • init/update: file count, symbol count, commit, warnings
  • query: formatted query results
  • status: staleness, commits behind, last updated

Comments

Markdown supported