← Back to Skills Marketplace
athola

Nm Conserve Context Map

by athola · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
34
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install nm-conserve-context-map
Description
Generates a compressed project context map to avoid expensive Read/Grep calls. Use at session start or before implementing features in an unfamiliar codebase
README (SKILL.md)

Night Market Skill — ported from claude-night-market/conserve. For the full experience with agents, hooks, and commands, install the Claude Code plugin.

Context Map

Generate a compressed context map for the current project. The map pre-compiles structural knowledge that AI assistants would otherwise discover through expensive Read/Grep calls, saving thousands of tokens per session.

When to Use

  • At the start of a session to understand project layout
  • Before implementing features to identify entry points
  • When exploring an unfamiliar codebase
  • To reduce token waste from Read calls
  • To identify hot files (high blast radius) before changes

What It Detects

Category Description
Structure Directory layout with file counts and languages
Dependencies Multi-ecosystem: Python, Node, Rust, Go, Java
Frameworks Framework detection from dependency analysis
Entry Points main.py, index.ts, CLI scripts, etc.
Import Graph File-to-file import relationships
Hot Files Files imported by 3+ others (high blast radius)
Routes FastAPI, Flask, Express, Hono API endpoints
Env Vars Environment variable references with defaults
Middleware Auth, CORS, rate-limit, logging patterns
Models/Schemas SQLAlchemy, Django, Pydantic, Prisma definitions
Token Savings Estimated tokens saved vs manual exploration

Procedure

  1. Run the scanner on the project root:
PYTHONPATH="$(find . -path '*/conserve/scripts' -type d \
  -print -quit 2>/dev/null || \
  echo 'plugins/conserve/scripts')" \
  python3 -m context_scanner .
  1. Present the output to the user as the project overview.

  2. Use the context map to guide subsequent file reads. Prioritize hot files and entry points first.

Options

Output

  • --format json for structured output
  • --max-tokens N to adjust output size (default: 5000)
  • --output FILE to save to a file

Modes

  • --blast FILE to show blast radius for a specific file
  • --section NAME to output a single section (routes, deps, env, hot-files, models, structure, middleware, frameworks)
  • --wiki-only to generate wiki articles without stdout

Opt-out

  • --no-cache to force a fresh scan
  • --no-wiki to skip wiki article generation

Wiki Articles

The scanner generates per-topic knowledge articles in .codesight/ for selective context loading:

python3 scanner.py .
# Creates .codesight/INDEX.md, auth.md, database.md, etc.

Load only what you need per session instead of the full map:

python3 scanner.py --section routes .
# ~200 tokens vs ~5,000 for the full map

Example Output

# Context Map: myproject
Files: 127

## Structure
  src                  42 files (Python)
  tests                18 files (Python)
  docs                  5 files (Markdown)

## Dependencies (Python)
Package manager: uv
  - fastapi 0.104.0
  - pydantic 2.5.0
  - sqlalchemy 2.0.0
  ...12 more

## Frameworks Detected
  - FastAPI
  - SQLAlchemy
  - Pytest

## Routes
  GET    /users          (src/routes/users.py)
  POST   /users          (src/routes/users.py)
  GET    /users/{id}     (src/routes/users.py)

## Hot Files (high blast radius)
  - src/models/base.py (12 importers)
  - src/utils/auth.py (8 importers)

## Environment Variables
  - DATABASE_URL (required)
  - SECRET_KEY (has default)

## Token Savings: ~12,600 tokens saved
  Routes: ~1,200
  Hot files: ~300
  Env vars: ~200
  File scanning: ~10,200
Usage Guidance
Install only if you want an agent to scan and summarize your local project. Use it on intended repositories, consider --no-wiki if you want to avoid creating .codesight/ files, and be aware that broad trigger words may cause the skill to be selected more often than expected.
Capability Assessment
Purpose & Capability
The stated purpose is to summarize a codebase by structure, dependencies, imports, routes, environment variable references, and related project metadata; those capabilities match the advertised context-map function.
Instruction Scope
The runtime procedure is scoped to the current project root, but several triggers such as "context," "scanning," and "exploration" are broad enough that the skill could activate for ordinary requests.
Install Mechanism
The package contains only SKILL.md, no executable payload, declared dependencies, install hooks, or bundled scripts.
Credentials
Repository-wide scanning is proportionate to the skill purpose, but users should run it only in repositories they intend to summarize because it may reveal project structure and environment variable names in the agent context.
Persistence & Privilege
No privilege escalation, credential use, network exfiltration, or background persistence is shown; the skill does disclose optional wiki article generation under .codesight/, which can write local files.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install nm-conserve-context-map
  3. After installation, invoke the skill by name or use /nm-conserve-context-map
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of nm-conserve-context-map. - Generates a compressed project context map to reduce expensive Read/Grep operations. - Detects project structure, key dependencies, frameworks, entry points, import graph, API routes, hot files, environment variables, middleware, and data models. - Offers command-line options for output format, section selection, token limits, and caching controls. - Produces per-topic wiki articles for selective context loading (.codesight/). - Estimates token savings vs manual code exploration.
Metadata
Slug nm-conserve-context-map
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Nm Conserve Context Map?

Generates a compressed project context map to avoid expensive Read/Grep calls. Use at session start or before implementing features in an unfamiliar codebase. It is an AI Agent Skill for Claude Code / OpenClaw, with 34 downloads so far.

How do I install Nm Conserve Context Map?

Run "/install nm-conserve-context-map" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Nm Conserve Context Map free?

Yes, Nm Conserve Context Map is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Nm Conserve Context Map support?

Nm Conserve Context Map is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Nm Conserve Context Map?

It is built and maintained by athola (@athola); the current version is v1.0.0.

💬 Comments