Agent skill

Repo Map Guide

by linora-u in linora-u/AgentLoom

Guide for generating and using AI-readable code maps. An agent skill from linora-u/AgentLoom.

No licenceAuto-check passedDevelopment

Install Repo Map Guide

skills CLI
$ npx skills add linora-u/AgentLoom --skill repo-map-guide -a claude-code

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

GitHub CLI
$ gh skill install linora-u/AgentLoom repo-map-guide --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/linora-u/AgentLoom.git skills-src && mkdir -p .claude/skills && cp -r skills-src/applications/repo_map/skills/repo-map-guide .claude/skills/repo-map-guide && 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
repo-map-guide
GitHub stars
168
Token cost
~554 tokens
SKILL.md length
104 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
None found

At a glance

Guide for generating and using AI-readable code maps. An agent skill from linora-u/AgentLoom.

  • Works in 5 steps: Supervisor 读取 progress 文件 → 跳过 status == "completed" 的目录 → 每次迭代前设置 status = "in_progress"(立即写回) → …
  • Tasks that involve Codebase onboarding
  • SKILL.md covers 概述, 输出结构, index.md 格式说明 and PageRank 重要性说明, plus 5 more sections
  • Calls python

What it does

Repo Map Guide is an agent skill from linora-u/AgentLoom. Guide for generating and using AI-readable code maps

Its SKILL.md is about 550 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Codebase onboarding. It works with Python and Model Context Protocol. The repository describes itself as: Simple, flexible workflow orchestration for multi-agent AI apps, with YAML configuration, runtime safety, observability, and resume support.

When your agent uses it

  • Tasks that involve Codebase onboarding

Example prompts

  • “/repo-map-guide”

Requirements

  • Python 3

Workflow steps

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

  1. Supervisor 读取 progress 文件
  2. 跳过 status == "completed" 的目录
  3. 每次迭代前设置 status = "in_progress"(立即写回)
  4. 完成后设置 status = "completed"(立即写回)
  5. 中断重启后,in_progress 状态自动重置为 pending

What it can do on your machine

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

    • python

    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

Repo Map Guide loads about 554 tokens when it runs. Until then it costs about 17 tokens; SKILL.md has 104 words of instructions outside code blocks.

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

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 104 words (~554 tokens).

“Repo Map 是一个代码地图生成系统,参考 Aider 的 RepoMap 实现, 将任意代码项目扫描后生成 AI 可读的 Markdown 文件目录结构。”

— opening of SKILL.md by linora-u
name
repo-map-guide

Read the full SKILL.md on GitHub

Files

Just SKILL.md in applications/repo_map/skills/repo-map-guide of linora-u/AgentLoom.

Open the folder on GitHubat commit 7df75b3

Compare with similar skills

Repo Map Guide 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.

Repo Map Guide compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Repo Map Guide this skilllinora-u/AgentLoom168—~554Automated safety check: PassNone
Codeguaardvark/guaardvark257—~559Automated safety check: PassMIT
LangBot Plugin Developmentlangbot-app/LangBot18k—~3.9kAutomated safety check: PassApache-2.0
GitDiagram Repository Overviewahmedkhaleel2004/gitdiagram18k—~427Automated safety check: PassMIT
Explore Codebase with Graphtirth8205/code-review-graph32k1 repos~335Automated safety check: PassMIT
LangBot Core Developmentlangbot-app/LangBot18k—~1.4kAutomated safety check: NotesApache-2.0

Similar skills

  • Code

    guaardvark/guaardvark

    Code intelligence over repositories Guaardvark has indexed: semantic code search, exact-text search, file listing, PageRank repository map, import dependency graph, reading one class or function…

    257 GitHub stars~559 tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • LangBot Plugin Development

    langbot-app/LangBot

    Guides building, debugging and testing LangBot plugins: components, SDK calls, README and locale rules, SDK pitfalls and WebSocket-based testing.

    18k GitHub stars~3.9k tokensUpdated today
    DevelopmentAuto-check passed
  • GitDiagram Repository Overview

    ahmedkhaleel2004/gitdiagram

    Explains the architecture of a public GitHub repository through GitDiagram: how the code is organized, the main components with paths, and a Mermaid diagram.

    18k GitHub stars~427 tokensUpdated today
    DevelopmentAuto-check passed
  • Explore Codebase with Graph

    tirth8205/code-review-graph

    Navigates a codebase through the code-review-graph MCP tools: architecture overview, symbol search, caller and callee tracing, flows and oversized functions.

    32k GitHub starsUsed in 1 repo~335 tokens
    DevelopmentAuto-check passed
  • LangBot Core Development

    langbot-app/LangBot

    Covers developing the LangBot core backend and web UI: dev setup, repo layout, API auth types, adding endpoints, migrations and keeping the MCP server in step.

    18k GitHub stars~1.4k tokensUpdated today
    DevelopmentAuto-check: notes
  • Code Graph Mermaid Diagrams

    trailofbits/skills

    Official

    Generates Mermaid diagrams from Trailmark code graphs, including call graphs, class hierarchies, module dependency maps, complexity heatmaps and attack surface data flows.

    7.5k GitHub stars~1.7k tokensUpdated today
    DevelopmentAuto-check passed

More from linora-u/AgentLoom

  • Agentloom Framework Skill

    linora-u/AgentLoom

    当用户需要理解、开发、扩展或验证 AgentLoom 框架能力时使用。覆盖创建/扩展 Application、设计单 Agent 或多 Agent、编写 Agent/Worker YAML、实现 Tool、创建私有 Skill 或 Hook、更新 README、验证 YAML/结构/运行结果。也适用于用户问“这个功能用 AgentLoom 怎么实现”。

    168 GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • Browser Harness Agentloom

    linora-u/AgentLoom

    A skill your agent uses when working on AgentLoom browser-harness integration or debugging applications/browserharnessprobe: creating or updating the probe Application, installing the external…

    168 GitHub stars~1.3k tokensUpdated today
    Auto-check passed

Categories

Questions about Repo Map Guide

What does Repo Map Guide do?

Guide for generating and using AI-readable code maps. An agent skill from linora-u/AgentLoom. Repo Map Guide is an agent skill from linora-u/AgentLoom.

When should I use Repo Map Guide?

Repo Map Guide fits situations like: tasks that involve Codebase onboarding.

How do I install Repo Map Guide in Claude Code?

Run `npx skills add linora-u/AgentLoom --skill repo-map-guide -a claude-code`. Or copy the skill folder (applications/repo_map/skills/repo-map-guide in linora-u/AgentLoom) into .claude/skills/repo-map-guide in your project. Claude Code loads it when a task matches its description.

How do I install Repo Map Guide in Codex?

Run `npx skills add linora-u/AgentLoom --skill repo-map-guide -a codex`. Or copy the skill folder (applications/repo_map/skills/repo-map-guide in linora-u/AgentLoom) into .agents/skills/repo-map-guide in your project. Codex loads it when a task matches its description.

Can I use Repo Map Guide 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 linora-u/AgentLoom --skill repo-map-guide -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/repo-map-guide, .gemini/skills/repo-map-guide, .github/skills/repo-map-guide and .opencode/skills/repo-map-guide in your project.

What does Repo Map Guide need to run?

Going by SKILL.md and its folder, Repo Map Guide needs the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Repo Map Guide 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 Repo Map Guide 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 Repo Map Guide use?

No licence was found for Repo Map Guide or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Repo Map Guide use?

About 554 tokens (SKILL.md is roughly 2.2k 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 Repo Map Guide?

Skills that share tags, products or a category with Repo Map Guide: Code (guaardvark/guaardvark, 257 stars), LangBot Plugin Development (langbot-app/LangBot, 18k stars), GitDiagram Repository Overview (ahmedkhaleel2004/gitdiagram, 18k stars) and Explore Codebase with Graph (tirth8205/code-review-graph, 32k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Repo Map Guide?

linora-u (a GitHub user) maintains it in linora-u/AgentLoom, which has 168 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 10, 2026.

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