Agent skill

Codemap

Generate, update, or drift-check agent-facing CodeMaps as progressive code terrain indexes for projects, features, capabilities, functions, modules, or bug chains.

MITAuto-check passed

Install Codemap

skills CLI

$ npx skills add openyida/openyida --skill codemap -a claude-code

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

GitHub CLI

$ gh skill install openyida/openyida codemap --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/openyida/openyida.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/codemap .claude/skills/codemap && 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/

Paste into Claude Code

Install the "codemap" agent skill from https://github.com/openyida/openyida/tree/main/.agents/skills/codemap into .claude/skills/codemap/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "codemap", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/openyida/openyida/tree/main/.agents/skills/codemap

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add openyida/openyida --skill codemap -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install openyida/openyida codemap --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/openyida/openyida.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/codemap .agents/skills/codemap && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "codemap" agent skill from https://github.com/openyida/openyida/tree/main/.agents/skills/codemap into .agents/skills/codemap/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "codemap", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add openyida/openyida --skill codemap -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install openyida/openyida codemap --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/openyida/openyida.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/codemap .cursor/skills/codemap && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "codemap" agent skill from https://github.com/openyida/openyida/tree/main/.agents/skills/codemap into .cursor/skills/codemap/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "codemap", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/openyida/openyida.git --path .agents/skills/codemap

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add openyida/openyida --skill codemap -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install openyida/openyida codemap --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/openyida/openyida.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/codemap .gemini/skills/codemap && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "codemap" agent skill from https://github.com/openyida/openyida/tree/main/.agents/skills/codemap into .gemini/skills/codemap/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "codemap", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install openyida/openyida codemap

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add openyida/openyida --skill codemap -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/openyida/openyida.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/codemap .github/skills/codemap && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "codemap" agent skill from https://github.com/openyida/openyida/tree/main/.agents/skills/codemap into .github/skills/codemap/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "codemap", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add openyida/openyida --skill codemap -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install openyida/openyida codemap --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/openyida/openyida.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/codemap .opencode/skills/codemap && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "codemap" agent skill from https://github.com/openyida/openyida/tree/main/.agents/skills/codemap into .opencode/skills/codemap/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "codemap", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: codemap
GitHub stars: 220
Token cost: ~1k tokens
SKILL.md length: 437 words
Files: 8 (incl. references)
Skills in repo: 58
Repo updated: Sep 30, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Generate, update, or drift-check agent-facing CodeMaps as progressive code terrain indexes for projects, features, capabilities, functions, modules, or bug chains.

Works in 9 steps: Restate the requested scope and choose… → Before writing a durable CodeMap, tell… → Read references/principles.md when the… → …
Codex needs to inspect an unfamiliar codebase
SKILL.md covers Core Position, Workflow, Templates and Output Rules
Calls rg

What it does

Codemap is an agent skill from openyida/openyida. Generate, update, or drift-check agent-facing CodeMaps as progressive code terrain indexes for projects, features, capabilities, functions, modules, or bug chains. Use when Codex needs to inspect an unfamiliar codebase, map a feature/capability from entry to effect, create or update mydocs/codemap/, answer createcodemap, MAP, PROJECT MAP, code terrain, impact-map, "where should the agent look first", check whether existing CodeMaps are stale after a diff, or prepare SDD-RIPER Research without loading the whole…

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files, including reference files (for example `agents/openai.yaml`, `package.json` and `references/drift-check.md`).

The repository describes itself as: Your own personal YiDA AI assistant! The licence is MIT.

When your agent uses it

Codex needs to inspect an unfamiliar codebase
Map a feature/capability from entry to effect
Update mydocs/codemap/
Answer createcodemap

Example prompts

“where should the agent look first”
“/codemap”

Workflow steps

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

Restate the requested scope and choose mode
Before writing a durable CodeMap, tell the user why a map/update is useful, the selected mode, scope, and expected path. Do not silently…
Read references/principles.md when the output shape, boundary, or CodeWiki-vs-CodeMap distinction matters.
For drift checks, read references/drift-check.md.
For updating an existing map, read references/update-existing.md.
Inspect code with search first (rg, rg --files, language-aware tools if available). Prefer source facts over inferred naming matches.
Build progressive Context Tree Nodes
Write the map under mydocs/codemap/ when the user requests a durable artifact or the work feeds SDD-RIPER Research
Keep the CodeMap narrow enough to guide the next agent action. Do not paste large source blocks or turn it into a narrative system document.

What it can do on your machine

Read from SKILL.md and the folder at commit 3dd4693. 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:
- rg
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 loads about 1k tokens when it runs, and up to ~5k if it reads all its reference files. Until then it costs about 140 tokens; SKILL.md has 437 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~140
When it runs · the whole SKILL.md, loaded when a task matches: ~1k
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~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

The full file from openyida/openyida at commit 3dd4693, republished under its MIT licence (© openyida). 437 words, ~1,015 tokens.

Download SKILL.mdSave it as .claude/skills/codemap/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.

name: codemap
description: Generate, update, or drift-check agent-facing CodeMaps as progressive code terrain indexes for projects, features, capabilities, functions, modules, or bug chains. Use when Codex needs to inspect an unfamiliar codebase, map a feature/capability from entry to effect, create or update `mydocs/codemap/*`, answer `create_codemap`, `MAP`, `PROJECT MAP`, code terrain, impact-map, "where should the agent look first", check whether existing CodeMaps are stale after a diff, or prepare SDD-RIPER Research without loading the whole repository into context.
version: 0.1.0
x-source: aone-open

Codemap

Core Position

Create CodeMaps for agents, not CodeWiki for humans.

CodeMap saves context attention, not necessarily raw token count. It does not replace source code, tests, logs, or the current Spec. It routes the agent toward the right source-linked evidence, in the right order, with progressive disclosure.

Use a CodeMap as:

Project CodeMap: breadth-first project terrain, capability index, module boundaries, dependency index, and drill-down pointers.
Feature CodeMap: depth-first capability terrain from entry to effect, including branches, dependencies, risks, and validation entry points.

Workflow

Restate the requested scope and choose mode:
- feature: capability, business feature, bug chain, API flow, function/class-centered investigation.
- project: repository, service, package, subsystem, or first-time onboarding map.
- drift-check: compare current diff or touched files with existing CodeMaps.
- update-existing: refresh an existing CodeMap after code terrain changes.
Before writing a durable CodeMap, tell the user why a map/update is useful, the selected mode, scope, and expected path. Do not silently write persistent maps unless current task approval already covers it.
Read references/principles.md when the output shape, boundary, or CodeWiki-vs-CodeMap distinction matters.
For drift checks, read references/drift-check.md.
For updating an existing map, read references/update-existing.md.
Inspect code with search first (rg, rg --files, language-aware tools if available). Prefer source facts over inferred naming matches.
Build progressive Context Tree Nodes:
- start with a small orientation node;
- add capability, module, entry, branch, effect, dependency, risk, and validation nodes only where they route future context;
- keep compact indexes as lookup tables, not as the main structure;
- point nodes to files, functions, classes, tests, configs, logs, and related maps;
- mark each important relationship as confirmed, inferred, or unknown.
Write the map under mydocs/codemap/ when the user requests a durable artifact or the work feeds SDD-RIPER Research:
- feature: mydocs/codemap/YYYY-MM-DD_hh-mm_<feature>功能.md
- project: mydocs/codemap/YYYY-MM-DD_hh-mm_<project>项目总图.md
Keep the CodeMap narrow enough to guide the next agent action. Do not paste large source blocks or turn it into a narrative system document.

Show full SKILL.md (117 more words)Show less

Templates

For feature/capability maps, follow references/feature-template.md.
For project/system maps, follow references/project-template.md.
For drift checks, follow references/drift-check.md.
For existing map updates, follow references/update-existing.md.
If a task spans multiple repositories, create one Project CodeMap per relevant project, then add a separate interface or cross-service flow summary.

Output Rules

Prefer path-linked, source-grounded bullets over prose.
Separate Confirmed, Inferred, and Unknown.
Include Next Drill-Down so the next agent knows what to read only if needed.
Include Validation Entry so the map can feed Spec / Plan / Review.
Treat stale or conflicting CodeMaps as indexes to re-check, not truth.
Do not treat CodeMap as a changelog. Update only terrain-changing facts: entries, flows, module boundaries, dependencies, risks, validation entry points, or behavior rule locations.

Files

SKILL.md and 7 other files (references) in .agents/skills/codemap of openyida/openyida.

SKILL.md
agents/openai.yaml
package.json
references/drift-check.md
references/feature-template.md
references/principles.md
references/project-template.md
references/update-existing.md

Open the folder on GitHubat commit 3dd4693

Compare with similar skills

Codemap 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 compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Codemap this skillopenyida/openyida	220	—	~1k	Automated safety check: Pass	MIT	7 days ago
Driftalsk1992/CloddsBot	2.9k	—	~299	Automated safety check: Pass	MIT	5 days ago
Harness Drift From Historyruvnet/ruflo	74k	—	~632	Automated safety check: Notes	MIT	today
Hugging Face Datasetssickn33/agentic-awesome-skills	47k	2 repos	~1.1k	Automated safety check: Pass	MIT	yesterday
Hugging Face Paperssickn33/agentic-awesome-skills	47k	1 repos	~2.5k	Automated safety check: Pass	Apache-2.0	yesterday
SEO Driftsickn33/agentic-awesome-skills	47k	1 repos	~1.8k	Automated safety check: Pass	MIT	yesterday

Similar skills

Drift
alsk1992/CloddsBot
Drift Protocol - perpetuals and prediction markets on Solana
2.9k GitHub stars~299 tokensUpdated 5 days ago
Auto-check passed
Harness Drift From History
ruvnet/ruflo
One-command drift detection. An agent skill from ruvnet/ruflo.
74k GitHub stars~632 tokensUpdated today
DevelopmentAuto-check: notes
Hugging Face Datasets
sickn33/agentic-awesome-skills
Create and manage datasets on Hugging Face Hub. An agent skill from sickn33/agentic-awesome-skills.
47k GitHub starsUsed in 2 repos~1.1k tokens
AI & LLM EngineeringAuto-check passed
Hugging Face Papers
sickn33/agentic-awesome-skills
Look up and read Hugging Face paper pages in markdown, and use the papers API for structured metadata such as authors, linked models/datasets/spaces, Github repo and project page.
47k GitHub starsUsed in 1 repo~2.5k tokens
AI & LLM EngineeringAuto-check passed
SEO Drift
sickn33/agentic-awesome-skills
Snapshot a site's SEO state and detect ranking, indexation, metadata, canonical, robots, schema, and on-page regressions over time.
47k GitHub starsUsed in 1 repo~1.8k tokens
Marketing & SEOAuto-check passed
Hugging Face Community Evals
sickn33/agentic-awesome-skills
Run evaluations for Hugging Face Hub models using inspect-ai and lighteval on local hardware.
47k GitHub starsUsed in 1 repo~1.9k tokens
AI & LLM EngineeringAuto-check passed

More from openyida/openyida

All 58 skills in this repo

Yida Canvas Custom Page
openyida/openyida
宜搭自定义页面开发规范，使用 YidaCodeCanvas 组件实现现代 React18 自定义页面。用于官网、看板、工作台、列表、详情、门户壳、可视化、hooks 交互、表单入口，以及需要门户组件、数据管理视图、成员、部门或上传组件的场景；发布层自动注入 yida/utils window 桥。
220 GitHub stars~4.3k tokensUpdated 7 days ago
Auto-check passed
Openyida Release
openyida/openyida
快速发布 OpenYida npm 正式版或测试版。用户说“发布正式版”“发布测试版”“发 beta”或要求按当天日期生成版本 tag 时使用；不用于宜搭应用或自定义页面发布。
220 GitHub stars~520 tokensUpdated 7 days ago
Auto-check passed
Yida Design Plan
openyida/openyida
Plan 模式的视觉设计分支。基于需求选择视觉方向，再结合业务页面规划维护 build-plan.json 的 visualStyle，供 CLI 派生 design.md。
220 GitHub stars~756 tokensUpdated 7 days ago
Auto-check passed
Yida Openyida Publish Guard
openyida/openyida
Prevent stale local OpenYida custom page source from overwriting live designer edits.
220 GitHub stars~1.2k tokensUpdated 7 days ago
Auto-check passed
Sdd Riper One Light
openyida/openyida
面向 GPT-5.5 等强模型和熟练用户的轻量 AI Agent Harness / checkpoint-driven coding skill。默认用户已经把任务切到基本可执行的最小混沌单元；模型自行分解、探索与推进，人类通过最终目标、最小 spec、复述、checkpoint、证据验证与回写来低干扰控盘。
220 GitHub stars~1.5k tokensUpdated 7 days ago
Auto-check passed
Yida Canvas Data Binding
openyida/openyida
自定义页面真实数据接入技能。用于在使用 YidaCodeCanvas 组件实现的页面中用 dataBinding + 发布层 yida/utils window 桥接入宜搭表单、流程 API、连接器代理或同源接口数据，处理返回体包裹解析、totalCount 保护、DataBridge 状态和静默刷新。触发词：dataBinding、DataBridge、数据桥、YidaCodeCanvas…
220 GitHub stars~2.4k tokensUpdated 7 days ago
Auto-check passed

Questions about Codemap

What does Codemap do?

Generate, update, or drift-check agent-facing CodeMaps as progressive code terrain indexes for projects, features, capabilities, functions, modules, or bug chains. Codemap is an agent skill from openyida/openyida. Generate, update, or drift-check agent-facing CodeMaps as progressive code terrain indexes for projects, features, capabilities, functions, modules, or bug chains.

When should I use Codemap?

Codemap fits situations like: Codex needs to inspect an unfamiliar codebase; map a feature/capability from entry to effect; update mydocs/codemap/; answer createcodemap.

How do I install Codemap in Claude Code?

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

How do I install Codemap in Codex?

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

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

What does Codemap need to run?

Going by SKILL.md and its folder, Codemap needs the command-line tools its instructions call (rg).

Does Codemap 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 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 use?

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

About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4k tokens, read only when the agent opens those files.

What are the alternatives to Codemap?

Skills that share tags, products or a category with Codemap: Drift (alsk1992/CloddsBot, 2.9k stars), Harness Drift From History (ruvnet/ruflo, 74k stars), Hugging Face Datasets (sickn33/agentic-awesome-skills, 47k stars) and Hugging Face Papers (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Codemap?

openyida (a GitHub organization) maintains it in openyida/openyida, which has 220 GitHub stars. The repository holds 58 skills in this directory. The repository was last updated on September 30, 2026.

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

Install Codemap

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Codemap

Core Position

Workflow

Templates

Output Rules

Files

Compare with similar skills

Similar skills

More from openyida/openyida

Questions about Codemap