Agent skill

Deep Code Read

by CiferaTeam in CiferaTeam/deep-code-reader

A skill your agent uses when you want to deeply understand an unfamiliar codebase and generate reusable cognitive skills from it, by providing a local path or GitHub URL

No licenceAuto-check passed

Install Deep Code Read

skills CLI
$ npx skills add CiferaTeam/deep-code-reader --skill deep-code-read -a claude-code

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

GitHub CLI
$ gh skill install CiferaTeam/deep-code-reader deep-code-read --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/CiferaTeam/deep-code-reader.git skills-src && mkdir -p .claude/skills && cp -r skills-src/deep-code-read .claude/skills/deep-code-read && 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
deep-code-read
GitHub stars
116
Token cost
~3.5k tokens
SKILL.md length
1,900 words
Files
4
Skills in repo
1
Repo updated
First seen
Licence
None found

At a glance

A skill your agent uses when you want to deeply understand an unfamiliar codebase and generate reusable cognitive skills from it, by providing a local path or GitHub URL

  • Works in 7 steps: Prepare → Scan → Deep Read (Agent A) → …
  • You want to deeply understand an unfamiliar codebase and generate reusable cognitive skills from it
  • SKILL.md covers Usage, Full Flow and Key Rules
  • Calls git; reaches github.com

What it does

Deep Code Read is an agent skill from CiferaTeam/deep-code-reader. Use when you want to deeply understand an unfamiliar codebase and generate reusable cognitive skills from it, by providing a local path or GitHub URL

Its SKILL.md is about 3.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `agent-a-prompt.md`, `agent-b-prompt.md` and `agent-c-prompt.md`).

It works with GitHub. The repository describes itself as: Coder reader skills that help you understand a repo and generate knowledge skills.

When your agent uses it

  • You want to deeply understand an unfamiliar codebase and generate reusable cognitive skills from it
  • By providing a local path

Example prompts

  • “/deep-code-read”

Requirements

  • Python 3

Workflow steps

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

  1. Prepare
  2. Scan
  3. Deep Read (Agent A)
  4. Verify (ABC Loop)
  5. Generate Global Index
  6. User Acceptance
  7. Cleanup

What it can do on your machine

Read from SKILL.md and the folder at commit 0aa2fee. 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

    Hosts in commands or code, which the agent is likely to contact:

    • github.com

    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

Deep Code Read loads about 3.5k tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 1,900 words of instructions outside code blocks.

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

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 1,900 words (~3,546 tokens).

“Systematically read and understand a codebase, producing a set of verified cognitive skills that capture deep knowledge — module capabilities, design logic, data structures, state flow, and modification guides.”

— opening of SKILL.md by CiferaTeam
name
deep-code-read
version
1.0.0
homepage
https://github.com/CiferaTeam/deep-code-reader

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files in deep-code-read of CiferaTeam/deep-code-reader.

  • SKILL.md
  • agent-a-prompt.md
  • agent-b-prompt.md
  • agent-c-prompt.md

Open the folder on GitHubat commit 0aa2fee

Compare with similar skills

Deep Code Read 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.

Deep Code Read compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Deep Code Read this skillCiferaTeam/deep-code-reader116—~3.5kAutomated safety check: PassNone
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Greplooponyx-dot-app/onyx32k4 repos~3.3kAutomated safety check: PassMIT
GitHub Deep Researchbytedance/deer-flow84k4 repos~1.3kAutomated safety check: PassMIT
Diagnosing Superpowers Sessionsobra/superpowers297k3 repos~1.7kAutomated safety check: PassMIT
Update V8 Versionopeninterpreter/openinterpreter69k2 repos~845Automated safety check: PassApache-2.0

Similar skills

  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed
  • Greploop

    onyx-dot-app/onyx

    Iteratively improves a PR (GitHub), MR (GitLab), or shelved changelist (Perforce) until Greptile gives it a 5/5 confidence score with zero unresolved comments.

    32k GitHub starsUsed in 4 repos~3.3k tokens
    DevelopmentAuto-check passed
  • GitHub Deep Research

    bytedance/deer-flow

    Researches a GitHub repository over four rounds using the GitHub API and web search, then writes a structured markdown report with timeline, metrics and Mermaid diagrams.

    84k GitHub starsUsed in 4 repos~1.3k tokens
    Research & ScienceAuto-check passed
  • Investigates a session where Superpowers went wrong, reads the transcripts on disk and produces an evidence-cited report, optionally prepared as a bug report for the maintainers.

    297k GitHub starsUsed in 3 repos~1.7k tokens
    Agent WorkflowsAuto-check passed
  • Update V8 Version

    openinterpreter/openinterpreter

    Bumps the pinned v8 and rusty_v8 versions in Codex, validates the release-candidate path with the v8-canary check, and traces failures to upstream build changes.

    69k GitHub starsUsed in 2 repos~845 tokens
    DevOps & CloudAuto-check passed
  • Last30days

    mvanhorn/last30days-skill

    Research what people actually say about any topic in the last 30 days.

    64k GitHub stars~7.9k tokensUpdated yesterday
    Research & ScienceAuto-check: notes

Works with

Questions about Deep Code Read

What does Deep Code Read do?

A skill your agent uses when you want to deeply understand an unfamiliar codebase and generate reusable cognitive skills from it, by providing a local path or GitHub URL. Deep Code Read is an agent skill from CiferaTeam/deep-code-reader.

When should I use Deep Code Read?

Deep Code Read fits situations like: you want to deeply understand an unfamiliar codebase and generate reusable cognitive skills from it; by providing a local path.

How do I install Deep Code Read in Claude Code?

Run `npx skills add CiferaTeam/deep-code-reader --skill deep-code-read -a claude-code`. Or copy the skill folder (deep-code-read in CiferaTeam/deep-code-reader) into .claude/skills/deep-code-read in your project. Claude Code loads it when a task matches its description.

How do I install Deep Code Read in Codex?

Run `npx skills add CiferaTeam/deep-code-reader --skill deep-code-read -a codex`. Or copy the skill folder (deep-code-read in CiferaTeam/deep-code-reader) into .agents/skills/deep-code-read in your project. Codex loads it when a task matches its description.

Can I use Deep Code Read 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 CiferaTeam/deep-code-reader --skill deep-code-read -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/deep-code-read, .gemini/skills/deep-code-read, .github/skills/deep-code-read and .opencode/skills/deep-code-read in your project.

What does Deep Code Read need to run?

Going by SKILL.md and its folder, Deep Code Read needs the command-line tools its instructions call (git). Our summary lists: Python 3.

Does Deep Code Read access the network?

SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Deep Code Read 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 Deep Code Read use?

No licence was found for Deep Code Read or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Deep Code Read use?

About 3.5k tokens (SKILL.md is roughly 14k 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 Deep Code Read?

Skills that share tags, products or a category with Deep Code Read: PR Babysitter (openinterpreter/openinterpreter, 69k stars), Greploop (onyx-dot-app/onyx, 32k stars), GitHub Deep Research (bytedance/deer-flow, 84k stars) and Diagnosing Superpowers Sessions (obra/superpowers, 297k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Deep Code Read?

CiferaTeam (a GitHub organization) maintains it in CiferaTeam/deep-code-reader, which has 116 GitHub stars. The repository was last updated on September 5, 2026.

Source: CiferaTeam/deep-code-reader on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.