Unified codebase intelligence. An agent skill from wednesday-solutions/ai-agent-skills.

MITAuto-check passedDevelopment

Install Codebase Intel

skills CLI
$ npx skills add wednesday-solutions/ai-agent-skills --skill codebase-intel -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install wednesday-solutions/ai-agent-skills codebase-intel --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/wednesday-solutions/ai-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/codebase-intel .claude/skills/codebase-intel && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
codebase-intel
GitHub stars
170
Token cost
~977 tokens
SKILL.md length
412 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

Unified codebase intelligence. An agent skill from wednesday-solutions/ai-agent-skills.

  • Works in 3 steps: Codebase Discovery & Q&A → Risk Assessment (Before Editing) → Graph Maintenance
  • Development work in your project
  • SKILL.md covers When to use, How to use — by task type, 🚫 Never and 📄 Source Citation
  • Calls git

What it does

Codebase Intel is an agent skill from wednesday-solutions/ai-agent-skills. Unified codebase intelligence. Handles all questions about structure, logic, risk, and dependencies. Combines natural-language Q&A with deterministic lookups and pre-edit blast radius checks.

Its SKILL.md is about 980 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. It works with Bash. The repository describes itself as: Pre-configured agent skills for Vibe Coded projects. These skills provide AI coding assistants (Claude Code, Cursor, etc.) with specific guidelines for code quality and design… The licence is MIT.

When your agent uses it

  • Development work in your project

Example prompts

  • “/codebase-intel”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Codebase Discovery & Q&A
  2. Risk Assessment (Before Editing)
  3. Graph Maintenance

What it can do on your machine

Read from SKILL.md and the folder at commit 80fa195. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Codebase Intel loads about 977 tokens when it runs. Until then it costs about 52 tokens; SKILL.md has 412 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~52
When it runs · the whole SKILL.md, loaded when a task matches
~977

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from wednesday-solutions/ai-agent-skills at commit 80fa195, republished under its MIT licence (© wednesday-solutions). 412 words, ~977 tokens.

Download SKILL.mdSave it as .claude/skills/codebase-intel/SKILL.md (or your agent's skills folder).
name
codebase-intel
description
Unified codebase intelligence. Handles all questions about structure, logic, risk, and dependencies. Combines natural-language Q&A with deterministic lookups and pre-edit blast radius checks.
permissions.allow
Bash(wednesday-skills query *), Bash(wednesday-skills blast *), Bash(wednesday-skills fill-gaps *), Read(.wednesday/codebase/MASTER.md), Bash(git log *)…

Codebase Intelligence Specialist

This skill provides a comprehensive understanding of the project's structure, intent, and risk. Use it for everything from high-level architecture questions to detailed impact analysis before editing code.

When to use

1. Codebase Discovery & Q&A
  • "What does tokenService do?" (Summaries)
  • "Where is the payment logic located?" (Role/Path mapping)
  • "Show me an overview of the architecture." (Stats & Entry points)
  • "Who last touched this file?" (Git history)
  • "Find circular dependencies or dead code." (Structural audit)
2. Risk Assessment (Before Editing)
  • "Is it safe to change this function signature?"
  • "What is the blast radius of this file?"
  • "What will break if I delete this constant?"
3. Graph Maintenance
  • If a query returns "not mapped" or coverage is low.
  • If you notice missing dependencies in the graph.

How to use — by task type

🔍 Discovery & Q&A
  1. File Summary: Bash(wednesday-skills query getFileSummary <file_path>)
    • Returns: Role, Summary, Risk Score, and Blast Radius.
  2. Architecture Stats: Bash(wednesday-skills query getCodebaseStats)
    • Use getHighConfidenceEntryPoints to identify the best starting files.
  3. Advanced Lookups:
    • Bash(wednesday-skills query getHighRiskFiles 70) — find critical technical debt.
    • Bash(wednesday-skills query getCircularDependencies) — find architectural smells.
    • Bash(wednesday-skills query getAllDeadCode) — find unreachable modules.
  4. Context: Read .wednesday/codebase/MASTER.md for danger zones and primary data flows.
  5. History: Bash(git log --follow --oneline -20 -- <file>) for authorship.
⚠️ Pre-Edit Safety Check (Mandatory)

Before modifying any file, you MUST perform these checks:

  1. Check Risk: Bash(wednesday-skills query getFileSummary <file_path>)
    • Score 0–30: Proceed directly.
    • Score 31–60: Inform dev of the risk, proceed with care.
    • Score 61–80: List direct dependents and transitive count; ask confirmation.
    • Score 81–100: STOP. Require explicit dev approval before touching.
  2. Blast Radius: Bash(wednesday-skills blast <file_path>::<symbol_optional>)
    • Review direct/transitive callers. Use this for cross-language impact (Go/Py/JS).
Show full SKILL.md (137 more words)Show less
🛠 Graph Maintenance & Gaps

If you hit "not mapped" or detect a missing link:

  1. Gap Check: Bash(sqlite3 .wednesday/graph.db "SELECT file_path, meta FROM nodes WHERE file_path LIKE '%<file>%'")
    • Check meta for gaps.eventEmitter, gaps.dynamic, etc.
  2. Fill Gaps: Bash(wednesday-skills fill-gaps --file <file> --min-risk 50)
    • Rule: Only edges with confidence > 0.70 are added automatically.
  3. Annotations: If gaps persist, ask dev to add // @wednesday-skills:connects-to <symbol> → <file>.
  4. Refresh: Bash(wednesday-skills analyze --incremental) after adding annotations.

🚫 Never

  • Guess: If data is missing, report "Not mapped" and suggest wednesday-skills map --full.
  • Skip Checks: Never edit a file with risk > 80 without explicit dev confirmation.
  • Token Bloat: Do NOT read raw source files to answer structural questions.
  • Add Unreliable Edges: Never manually add edges with confidence below 0.70.

📄 Source Citation

Always end with the source:

  • graph.db — Structural/Summary data
  • MASTER.md — Architectural context
  • git log — History/Authorship

© wednesday-solutions, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/codebase-intel of wednesday-solutions/ai-agent-skills.

Open the folder on GitHubat commit 80fa195

Compare with similar skills

Codebase Intel next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Codebase Intel compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Codebase Intel this skillwednesday-solutions/ai-agent-skills170—~977Automated safety check: PassMIT
Mole Bug Patternstw93/Mole70k—~2kAutomated safety check: PassGPL-3.0
CLI DeveloperJeffallan/claude-skills12k1 repos~1.2kAutomated safety check: PassMIT
JSON Processing with jqcharmbracelet/crush29k—~746Automated safety check: PassCustom licence
Segment CreateJanDeDobbeleer/oh-my-posh24k—~1.2kAutomated safety check: PassMIT
Omm Pushoh-my-mermaid/oh-my-mermaid2.5k—~441Automated safety check: PassMIT

Similar skills

  • A catalog of recurring bug shapes in the Mole Mac cleaner, used to review safety-sensitive diffs for deletion safety, unbounded commands, shell traps and weak tests.

    70k GitHub stars~2k tokensUpdated today
    DevelopmentAuto-check passed
  • CLI Developer

    Jeffallan/claude-skills

    Walks through designing, building and polishing a command-line tool: user workflow and command hierarchy, implementation in commander, click, typer or cobra, completions and cross-platform testing.

    12k GitHub starsUsed in 1 repo~1.2k tokens
    DevelopmentAuto-check passed
  • JSON Processing with jq

    charmbracelet/crush

    Explains the jq command built into Crush for querying, filtering and reshaping JSON, including its supported flags and where it differs from standard jq.

    29k GitHub stars~746 tokensUpdated today
    DevelopmentAuto-check passed
  • Segment Create

    JanDeDobbeleer/oh-my-posh

    Full scaffolding workflow for creating a new Oh My Posh segment.

    24k GitHub stars~1.2k tokensUpdated today
    DevelopmentAuto-check passed
  • Omm Push

    oh-my-mermaid/oh-my-mermaid

    Push architecture docs to oh-my-mermaid cloud. An agent skill from oh-my-mermaid/oh-my-mermaid.

    2.5k GitHub stars~441 tokensUpdated 6 mo ago
    DevelopmentAuto-check passed
  • FIXME Resolver

    tailcallhq/forgecode

    Finds every FIXME comment in a codebase, groups related ones across files into one task, implements the work they describe and removes the comments once it is done.

    7.6k GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed

More from wednesday-solutions/ai-agent-skills

All 10 skills in this repo
  • Brownfield Drift

    wednesday-solutions/ai-agent-skills

    Enforces architecture boundaries defined in PLAN.md. An agent skill from wednesday-solutions/ai-agent-skills.

    170 GitHub stars~669 tokensUpdated 4 mo ago
    Auto-check passed
  • Greenfield

    wednesday-solutions/ai-agent-skills

    Parallel persona planning for new projects. An agent skill from wednesday-solutions/ai-agent-skills.

    170 GitHub stars~914 tokensUpdated 4 mo ago
    Auto-check passed
  • PR Review

    wednesday-solutions/ai-agent-skills

    Fix engine for PR review comments. An agent skill from wednesday-solutions/ai-agent-skills.

    170 GitHub stars~661 tokensUpdated 4 mo ago
    Auto-check passed
  • Standards Kit

    wednesday-solutions/ai-agent-skills

    Unified development and design standards. An agent skill from wednesday-solutions/ai-agent-skills.

    170 GitHub stars~436 tokensUpdated 4 mo ago
    Auto-check passed
  • Wednesday Git

    wednesday-solutions/ai-agent-skills

    Unified Git workflow. An agent skill from wednesday-solutions/ai-agent-skills.

    170 GitHub stars~702 tokensUpdated 4 mo ago
    Auto-check passed
  • Module Audit Agent

    wednesday-solutions/ai-agent-skills

    A skill your agent uses when asked to audit a module, check its health, or assess whether it should be refactored.

    170 GitHub stars~438 tokensUpdated 4 mo ago
    Auto-check passed

Works with

Categories

Questions about Codebase Intel

What does Codebase Intel do?

Unified codebase intelligence. An agent skill from wednesday-solutions/ai-agent-skills. Codebase Intel is an agent skill from wednesday-solutions/ai-agent-skills. Unified codebase intelligence.

When should I use Codebase Intel?

Codebase Intel fits situations like: development work in your project.

How do I install Codebase Intel in Claude Code?

Run `npx skills add wednesday-solutions/ai-agent-skills --skill codebase-intel -a claude-code`. Or copy the skill folder (skills/codebase-intel in wednesday-solutions/ai-agent-skills) into .claude/skills/codebase-intel in your project. Claude Code loads it when a task matches its description.

How do I install Codebase Intel in Codex?

Run `npx skills add wednesday-solutions/ai-agent-skills --skill codebase-intel -a codex`. Or copy the skill folder (skills/codebase-intel in wednesday-solutions/ai-agent-skills) into .agents/skills/codebase-intel in your project. Codex loads it when a task matches its description.

Can I use Codebase Intel in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add wednesday-solutions/ai-agent-skills --skill codebase-intel -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/codebase-intel, .gemini/skills/codebase-intel, .github/skills/codebase-intel and .opencode/skills/codebase-intel in your project.

What does Codebase Intel need to run?

Going by SKILL.md and its folder, Codebase Intel needs the command-line tools its instructions call (git).

Does Codebase Intel access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Codebase Intel safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Codebase Intel use?

Codebase Intel is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Codebase Intel use?

About 977 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Codebase Intel?

Skills that share tags, products or a category with Codebase Intel: Mole Bug Patterns (tw93/Mole, 70k stars), CLI Developer (Jeffallan/claude-skills, 12k stars), JSON Processing with jq (charmbracelet/crush, 29k stars) and Segment Create (JanDeDobbeleer/oh-my-posh, 24k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Codebase Intel?

wednesday-solutions (a GitHub organization) maintains it in wednesday-solutions/ai-agent-skills, which has 170 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on May 26, 2026.

Source: wednesday-solutions/ai-agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.