Agent skill

Codemap Config Setup

by JordanCoin in JordanCoin/codemap

Writes or tunes .codemap/config.json so Codemap output centers on a repository's real source code instead of assets, fixtures and generated files.

MITAuto-check passedDevelopment

Install Codemap Config Setup

skills CLI
$ npx skills add JordanCoin/codemap --skill config-setup -a claude-code

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

GitHub CLI
$ gh skill install JordanCoin/codemap config-setup --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/JordanCoin/codemap.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/config-setup .claude/skills/config-setup && 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
config-setup
GitHub stars
704
Token cost
~650 tokens
SKILL.md length
305 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

Writes or tunes .codemap/config.json so Codemap output centers on a repository's real source code instead of assets, fixtures and generated files.

  • Works in 4 steps: .codemap/config.json is missing → The existing config looks like a bare… → Codemap output is dominated by assets,… → …
  • The repository has no .codemap/config.json yet
  • SKILL.md covers Goal, Use this when and Workflow
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

The skill inspects a repository and then creates or improves .codemap/config.json, the file that tells Codemap what to focus on. It starts by running codemap on the repo, optionally with its dependency view, noting stack markers such as Cargo.toml, go.mod, package.json or pyproject.toml, and spotting large non-code directories and noisy file extensions.

It first classifies the existing config as missing, boilerplate or tuned, then writes a conservative, code-first version: it keeps useful source-language filters, adds exclude entries for obvious non-code noise and sets a moderate depth for broad repos. Defaults differ by stack, for example src, tests, benches and examples for Rust, app and framework sources for iOS and Swift, dist and coverage excluded for TypeScript and JavaScript, and notebooks or data dumps de-prioritized for Python. A config that already looks curated gets minimal edits with an explanation, and the result is checked by rerunning codemap.

When your agent uses it

  • The repository has no .codemap/config.json yet
  • The existing Codemap config only holds generic bootstrap values
  • Codemap output is swamped by assets, fixtures, vendor trees or generated files
  • The stack is clear but Codemap is not highlighting the right directories

Example prompts

  • “Set up a Codemap config for this Rust repo; the sample PDFs and training data keep flooding the output.”
  • “The codemap output for our TypeScript monorepo is full of Storybook assets and dist files, so tune the config.”
  • “Check whether .codemap/config.json is just boilerplate and improve it without overwriting what is already curated.”

Requirements

  • The codemap CLI installed in the repository's environment

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. .codemap/config.json is missing
  2. The existing config looks like a bare bootstrap instead of a real project policy
  3. Codemap output is dominated by assets, fixtures, generated files, vendor trees, PDFs, screenshots, models, or training data
  4. The project stack is obvious, but Codemap is not prioritizing the right parts of the repo

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

    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

Codemap Config Setup loads about 650 tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 305 words of instructions outside code blocks.

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

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 JordanCoin/codemap at commit 253c8d6, republished under its MIT licence (© JordanCoin). 305 words, ~650 tokens.

Download SKILL.mdSave it as .claude/skills/config-setup/SKILL.md (or your agent's skills folder).
name
config-setup
description
Set up or tune .codemap/config.json so Codemap focuses on code-relevant parts of the repo. Use when config is missing, boilerplate, noisy, or mismatched to the stack.

Codemap Config Setup

Goal

Write or improve .codemap/config.json so future Codemap calls stay focused on the code that matters for this repo.

Use this when

  1. .codemap/config.json is missing
  2. The existing config looks like a bare bootstrap instead of a real project policy
  3. Codemap output is dominated by assets, fixtures, generated files, vendor trees, PDFs, screenshots, models, or training data
  4. The project stack is obvious, but Codemap is not prioritizing the right parts of the repo

Workflow

  1. Inspect the repo quickly before writing config

    • Run codemap .
    • If needed, run codemap --deps .
    • Note the stack markers (Cargo.toml, Package.swift, *.xcodeproj, go.mod, package.json, pyproject.toml, etc.)
    • Identify large non-code directories and noisy extensions
  2. Decide whether config is missing, boilerplate, or tuned

    • Missing: no .codemap/config.json
    • Boilerplate: only generic only values, no real shaping, no excludes despite obvious noise
    • Tuned: contains intentional project-specific includes/excludes, depth, or routing hints
  3. Write a conservative code-first config

    • Keep primary source-language only values when they help
    • Add exclude entries for obvious non-code noise
    • Set a moderate depth when the repo is broad
    • Avoid overfitting or excluding real source directories
  4. Prefer stack-aware defaults

    • Rust: focus src, tests, benches, examples; de-prioritize corpora, sample PDFs, training data, large generated artifacts
    • iOS/Swift: focus app/framework source, tests, package/project manifests; de-prioritize .xcassets, screenshots, snapshots, vendor/build outputs
    • TS/JS: focus src, apps, packages, tests; de-prioritize dist, coverage, Storybook assets, large fixture payloads
    • Python: focus package roots, tests, tool config; de-prioritize notebooks, data dumps, models, fixtures when they overwhelm code
    • Go: focus packages, cmd, internal, tests; de-prioritize generated assets, sample data, vendor-like noise
  5. Preserve user intent

    • If config already looks curated, do not replace it wholesale
    • Make minimal edits and explain why
  6. Verify immediately

    • Rerun codemap .
    • If the repo still looks noisy, refine exclude and possibly depth
    • Only rerun codemap --deps . after tree output looks reasonable

© JordanCoin, 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 .claude/skills/config-setup of JordanCoin/codemap.

Open the folder on GitHubat commit 253c8d6

Compare with similar skills

Codemap Config Setup 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.

Codemap Config Setup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Codemap Config Setup this skillJordanCoin/codemap704—~650Automated safety check: PassMIT
Repo Scaffoldmajiayu000/spellbook286—~651Automated safety check: PassMIT
Project Context SetupMathews-Tom/armory328—~1.2kAutomated safety check: PassMIT
Ax Agent Contextdosco/aithy107—~903Automated safety check: PassApache-2.0
Add a Language to CodeGraphcolbymchenry/codegraph73k—~2.7kAutomated safety check: PassMIT
Nx Generatenomcopter/react-mosaic4.8k7 repos~1.9kAutomated safety check: PassCustom licence

Similar skills

  • Repo Scaffold

    majiayu000/spellbook

    Scaffold or standardize a production-ready repository structure with specs, source layout, tests, CI, agent context, config examples, release notes, and operational docs.

    286 GitHub stars~651 tokensUpdated today
    DevelopmentAuto-check passed
  • Project Context Setup

    Mathews-Tom/armory

    Scaffolds per-repository agent context so coding agents share the same issue tracker rules, triage label vocabulary, domain glossary, ADR layout, and handoff conventions.

    328 GitHub stars~1.2k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • Ax Agent Context

    dosco/aithy

    This skill helps an LLM pick the right AxAgent context tool for a job - contextMap for recurring corpora, contextPolicy presets for within-run trajectory compaction, agent.optimize for offline GEPA…

    107 GitHub stars~903 tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Add a Language to CodeGraph

    colbymchenry/codegraph

    Adds tree-sitter support for a new language to the codegraph project, then tests it and benchmarks extraction quality and retrieval value on real repositories.

    73k GitHub stars~2.7k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Nx Generate

    nomcopter/react-mosaic

    Generate code using nx generators. An agent skill from nomcopter/react-mosaic.

    4.8k GitHub starsUsed in 7 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Ponytail

    DavidObando/gsharp

    Forces the laziest solution that actually works, simplest, shortest, most minimal.

    565 GitHub starsUsed in 8 repos~1.7k tokens
    DevelopmentAuto-check passed

More from JordanCoin/codemap

  • Codemap

    JordanCoin/codemap

    Gives an agent a quick map of a codebase's structure, dependencies, changes and handoffs, and tunes per-project config so the output stays code-first.

    704 GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Codemap Config Setup

What does Codemap Config Setup do?

Writes or tunes .codemap/config.json so Codemap output centers on a repository's real source code instead of assets, fixtures and generated files. json, the file that tells Codemap what to focus on.toml, and spotting large non-code directories and noisy file extensions.

When should I use Codemap Config Setup?

Codemap Config Setup fits situations like: the repository has no .codemap/config.json yet; the existing Codemap config only holds generic bootstrap values; codemap output is swamped by assets, fixtures, vendor trees or generated files; the stack is clear but Codemap is not highlighting the right directories.

How do I install Codemap Config Setup in Claude Code?

Run `npx skills add JordanCoin/codemap --skill config-setup -a claude-code`. Or copy the skill folder (.claude/skills/config-setup in JordanCoin/codemap) into .claude/skills/config-setup in your project. Claude Code loads it when a task matches its description.

How do I install Codemap Config Setup in Codex?

Run `npx skills add JordanCoin/codemap --skill config-setup -a codex`. Or copy the skill folder (.claude/skills/config-setup in JordanCoin/codemap) into .agents/skills/config-setup in your project. Codex loads it when a task matches its description.

Can I use Codemap Config Setup 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 JordanCoin/codemap --skill config-setup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/config-setup, .gemini/skills/config-setup, .github/skills/config-setup and .opencode/skills/config-setup in your project.

What does Codemap Config Setup need to run?

SKILL.md names no scripts, command-line tools or credentials: Codemap Config Setup is instructions for the agent only. Our summary lists: The codemap CLI installed in the repository's environment.

Does Codemap Config Setup access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Codemap Config Setup 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 Codemap Config Setup use?

Codemap Config Setup 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 Codemap Config Setup use?

About 650 tokens (SKILL.md is roughly 2.6k 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 Codemap Config Setup?

Skills that share tags, products or a category with Codemap Config Setup: Repo Scaffold (majiayu000/spellbook, 286 stars), Project Context Setup (Mathews-Tom/armory, 328 stars), Ax Agent Context (dosco/aithy, 107 stars) and Add a Language to CodeGraph (colbymchenry/codegraph, 73k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Codemap Config Setup?

JordanCoin (a GitHub user) maintains it in JordanCoin/codemap, which has 704 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 7, 2026.

Source: JordanCoin/codemap on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.