Agent skill

Agentmap Generator

by MatrixAges in MatrixAges/polywise

Guides the generation, reading, and updating of agentmap.md files.

MITAuto-check passedKnowledge Management

Install Agentmap Generator

skills CLI
$ npx skills add MatrixAges/polywise --skill agentmap-generator -a claude-code

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

GitHub CLI
$ gh skill install MatrixAges/polywise agentmap-generator --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/MatrixAges/polywise.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.opencode/skills/agentmap-generator .claude/skills/agentmap-generator && 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
agentmap-generator
GitHub stars
662
Token cost
~489 tokens
SKILL.md length
220 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Guides the generation, reading, and updating of agentmap.md files.

  • Works in 3 steps: When to Trigger Updates → AgentMap Structure → Maintenance Specifications
  • Knowledge Management work in your project
  • SKILL.md covers 1. When to Trigger Updates, 2. AgentMap Structure and 3. Maintenance Specifications
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Agentmap Generator is an agent skill from MatrixAges/polywise. Guides the generation, reading, and updating of agentmap.md files. This skill ensures a consistent and up-to-date codebase map for AI Agents.

Its SKILL.md is about 490 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 Knowledge Management. The repository describes itself as: The open source agentic content system to make your contents alive. Self-hosted on any platform. ◑. The licence is MIT.

When your agent uses it

  • Knowledge Management work in your project

Example prompts

  • “Use the agentmap-generator skill to guide the generation, reading, and updating of agentmap.md files”
  • “/agentmap-generator”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. When to Trigger Updates
  2. AgentMap Structure
  3. Maintenance Specifications

What it can do on your machine

Read from SKILL.md and the folder at commit f8d2320. 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 (its code samples are json).

    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

Agentmap Generator loads about 489 tokens when it runs. Until then it costs about 40 tokens; SKILL.md has 220 words of instructions outside code blocks.

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

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 MatrixAges/polywise at commit f8d2320, republished under its MIT licence (© MatrixAges). 220 words, ~489 tokens.

Download SKILL.mdSave it as .claude/skills/agentmap-generator/SKILL.md (or your agent's skills folder).
name
agentmap-generator
description
Guides the generation, reading, and updating of agentmap.md files. This skill ensures a consistent and up-to-date codebase map for AI Agents.

AgentMap Generation Guide

This skill provides mandatory specifications for maintaining agentmap.md in the project, enabling AI to accurately grasp the latest physical file structure and module functional division of the codebase.

1. When to Trigger Updates

  • After modifying any file: As long as you have added, renamed, or deleted files within a package, or significantly changed the responsibilities of core modules, you must update the agentmap.md in that package's root directory before ending the task.

2. AgentMap Structure

A standard agentmap.md must contain the following sections:

2.1 Package Description

A brief description of the package's core responsibilities (e.g., "This is the frontend rendering process package for the application, responsible for all UI and state management").

2.2 Tree JSON Status Tree

This is the most important part and must be wrapped in a Markdown code block (``json). It represents the latest folder structure and core file responsibilities within the current package.

json
{
	"src": {
		"components": {
			"Button": {
				"index.tsx": "Generic button component"
			}
		},
		"models": {
			"global.ts": "Global singleton state model"
		}
	}
}

3. Maintenance Specifications

  • Accuracy: The JSON tree must truthfully reflect the current file structure on disk. Fabricating non-existent files is strictly prohibited.
  • Protected Directories: Never include folders starting with __ (double underscore) (e.g., __codegrave__) in agentmap.md.
  • Conciseness: File descriptions should be as brief as possible (within one line), only needing to explain "what it does". For nested levels, if the directory is very complex internally, only list the core entry files.

© MatrixAges, 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 .opencode/skills/agentmap-generator of MatrixAges/polywise.

Open the folder on GitHubat commit f8d2320

Compare with similar skills

Agentmap Generator 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.

Agentmap Generator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Agentmap Generator this skillMatrixAges/polywise662—~489Automated safety check: PassMIT
Baoyu URL To Markdownsdyckjq-lab/llm-wiki-skill2.5k3 repos~3.2kAutomated safety check: PassNone
Logseq Review Workflow Evallogseq/logseq45k—~1kAutomated safety check: PassAGPL-3.0
Obsidian CLIAtmosphere/atmosphere3.8k13 repos~795Automated safety check: PassApache-2.0
Esm Cjs Risk Scanlogseq/logseq45k—~3.3kAutomated safety check: PassAGPL-3.0
Capture Conversationoutline/outline41k—~474Automated safety check: PassCustom licence

Similar skills

  • Baoyu URL To Markdown

    sdyckjq-lab/llm-wiki-skill

    Fetch any URL and convert to markdown using Chrome CDP. An agent skill from sdyckjq-lab/llm-wiki-skill.

    2.5k GitHub starsUsed in 3 repos~3.2k tokens
    Knowledge ManagementAuto-check passed
  • Compare two revisions of the Logseq logseq-review-workflow skill by running the same review prompt against isolated before and after skill snapshots, collecting both outputs, and producing a…

    45k GitHub stars~1k tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Obsidian CLI

    Atmosphere/atmosphere

    Interact with Obsidian vaults using the Obsidian CLI to read, create, search, and manage notes, tasks, properties, and more.

    3.8k GitHub starsUsed in 13 repos~795 tokens
    Knowledge ManagementAuto-check passed
  • Esm Cjs Risk Scan

    logseq/logseq

    Scan Logseq ClojureScript Node/Electron targets for npm module loading risks, especially ESM-only packages that may fail when loaded through js/require or shadow-cljs require-based shims.

    45k GitHub stars~3.3k tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Capture Conversation

    outline/outline

    Save the current conversation, a decision, or a set of notes as a document in an Outline collection; use when the user wants to keep what was discussed in their knowledge base.

    41k GitHub stars~474 tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Karpathy LLM Wiki

    Astro-Han/karpathy-llm-wiki

    A skill your agent uses when building or maintaining a personal LLM-powered knowledge base.

    2.4k GitHub stars~3.6k tokensUpdated 2 mo ago
    Knowledge ManagementAuto-check passed

More from MatrixAges/polywise

All 11 skills in this repo
  • Chrome Cdp

    MatrixAges/polywise

    Interacts with local browser via Chrome DevTools Protocol (only triggered after user explicitly requests to inspect, debug, or interact with pages open in Chrome)

    662 GitHub stars~800 tokensUpdated 3 mo ago
    Auto-check passed
  • Skill Generator

    MatrixAges/polywise

    Called when users need to create new OpenCode skills. An agent skill from MatrixAges/polywise.

    662 GitHub stars~333 tokensUpdated 3 mo ago
    Auto-check passed
  • CSS

    MatrixAges/polywise

    Guides styling implementation using TailwindCSS + CSS Modules.

    662 GitHub stars~1.3k tokensUpdated 3 mo ago
    Auto-check passed
  • Erpc Communication

    MatrixAges/polywise

    Guides using eRPC (electron-tRPC) for inter-process communication (IPC) between Electron main and renderer processes.

    662 GitHub stars~618 tokensUpdated 3 mo ago
    Auto-check passed
  • I18n

    MatrixAges/polywise

    Guides internationalization (i18n) implementation using i18next with TypeScript.

    662 GitHub stars~898 tokensUpdated 3 mo ago
    Auto-check passed
  • Mobx

    MatrixAges/polywise

    Guides state management implementation using MobX + tsyringe.

    662 GitHub stars~1.3k tokensUpdated 3 mo ago
    Auto-check passed

Questions about Agentmap Generator

What does Agentmap Generator do?

Guides the generation, reading, and updating of agentmap.md files. Agentmap Generator is an agent skill from MatrixAges/polywise.md files.

When should I use Agentmap Generator?

Agentmap Generator fits situations like: knowledge Management work in your project.

How do I install Agentmap Generator in Claude Code?

Run `npx skills add MatrixAges/polywise --skill agentmap-generator -a claude-code`. Or copy the skill folder (.opencode/skills/agentmap-generator in MatrixAges/polywise) into .claude/skills/agentmap-generator in your project. Claude Code loads it when a task matches its description.

How do I install Agentmap Generator in Codex?

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

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

What does Agentmap Generator need to run?

SKILL.md names no scripts, command-line tools or credentials: Agentmap Generator is instructions for the agent only.

Does Agentmap Generator 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 Agentmap Generator 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 Agentmap Generator use?

Agentmap Generator 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 Agentmap Generator use?

About 489 tokens (SKILL.md is roughly 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 Agentmap Generator?

Skills that share tags, products or a category with Agentmap Generator: Baoyu URL To Markdown (sdyckjq-lab/llm-wiki-skill, 2.5k stars), Logseq Review Workflow Eval (logseq/logseq, 45k stars), Obsidian CLI (Atmosphere/atmosphere, 3.8k stars) and Esm Cjs Risk Scan (logseq/logseq, 45k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agentmap Generator?

MatrixAges (a GitHub organization) maintains it in MatrixAges/polywise, which has 662 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on June 11, 2026.

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