# Codemap Config Setup

> Configure and tune .codemap/config.json. Trigger this skill ONLY when codemap CLI output is overwhelmed by irrelevant files (like assets, generated code, or vendor folders), or when the prompt-submit hook explicitly suggests config-setup.

- **Type:** Skill
- **Install:** `agentstack add skill-shalomb-agent-skills-codemap-config-setup`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [shalomb](https://agentstack.voostack.com/s/shalomb)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [shalomb](https://github.com/shalomb)
- **Source:** https://github.com/shalomb/agent-skills/tree/main/skills/codemap-config-setup

## Install

```sh
agentstack add skill-shalomb-agent-skills-codemap-config-setup
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [shalomb](https://github.com/shalomb)
- **Source:** [shalomb/agent-skills](https://github.com/shalomb/agent-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-shalomb-agent-skills-codemap-config-setup
- Seller: https://agentstack.voostack.com/s/shalomb
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.