English | 繁體中文
Turn discussions into structured, human-readable, and optionally interactive knowledge maps.
TalkMap is an open Agent Skill and Codex Plugin that converts conversations, brainstorming, research threads, technical reviews, and decision processes into a standalone HTML knowledge map.
Instead of producing a flat Markdown summary, TalkMap preserves the reasoning path:
- The problem or opportunity.
- Relevant context and constraints.
- Options, objections, and trade-offs.
- Confirmed decisions, proposals, assumptions, risks, conflicts, and open questions.
- Decision rationale and revisit conditions.
- Concrete next actions.
- A lightweight interactive explanation when interaction adds genuine validation value.
- Product and feature planning.
- Software architecture and technical decisions.
- Bug investigations and design reviews.
- Business strategy and operational planning.
- Research synthesis and hypothesis development.
- Educational design and curriculum planning.
- Workflow redesign and team decisions.
- A raw transcript generator.
- A generic meeting-minutes template.
- A UI-only prototyping tool.
- A replacement for production application development.
- A tool that invents requirements or presents assumptions as confirmed decisions.
TalkMap is instruction-first and has no package, runtime, backend, framework, MCP server, or network dependency. The portable Skill requires a client that supports the Agent Skills format and can read SKILL.md. The repository also includes the manifest and marketplace metadata required to install it as a Codex Plugin.
GitHub repository: novoicefire/talkmap.
Add the GitHub repository as a Codex marketplace:
codex plugin marketplace add novoicefire/talkmapThen open /plugins in Codex CLI, or open Plugins in the Codex desktop app, and install TalkMap from the added marketplace. Start a new task after installation so Codex loads the bundled Skill.
Copy this directory from the repository:
plugins/talkmap/skills/talkmap
Place it at either location:
User: ~/.agents/skills/talkmap
Project: .agents/skills/talkmap
The installed directory must be named talkmap. Invoke it explicitly with:
$talkmap
Codex may also select TalkMap automatically when the request matches the Skill description. Restart Codex if a newly created top-level skills directory is not discovered immediately.
Copy the same portable Skill directory:
plugins/talkmap/skills/talkmap
Place it at either location:
User: ~/.claude/skills/talkmap
Project: .claude/skills/talkmap
Invoke explicitly with:
/talkmap
Claude Code may also select TalkMap automatically when the request matches the Skill description. Restart Claude Code if the top-level skills directory did not exist when the session started.
Download and extract the repository ZIP, then copy plugins/talkmap/skills/talkmap into the relevant Codex or Claude Code Skills directory. The copied directory must remain named talkmap.
For a Codex Plugin installation, refresh the marketplace, then update or reinstall TalkMap through /plugins or the desktop Plugin directory:
codex plugin marketplace upgrade talkmapFor a direct Skill installation, update the repository and copy plugins/talkmap/skills/talkmap over the installed copy. Remove TalkMap through the Codex plugin browser, or delete its talkmap directory from the relevant direct-Skill location.
Use TalkMap explicitly with a complete request:
Use TalkMap to organize everything we have discussed so far.
TalkMap follows the user's requested language and defaults to Traditional Chinese when no language is specified.
Use TalkMap to organize our discussion about the new student scheduling system.
Use TalkMap to turn the architecture discussion into a readable HTML decision record.
Do not create an interactive prototype.
Use TalkMap to summarize this business-planning discussion.
Create a scenario explorer only if it helps compare pricing options.
Use TalkMap to document the bug investigation, including symptoms, evidence,
root-cause hypotheses, rejected fixes, confirmed findings, and next actions.
TalkMap:
- Uses the conversation and supplied materials as primary sources.
- Separates facts, proposals, assumptions, risks, conflicts, and unknowns.
- Preserves decision rationale and meaningful alternatives.
- Produces one responsive, accessible, standalone HTML document.
- Adds interaction only when it improves understanding or validation.
- Does not claim fake data, persistence, authentication, API access, or production behavior.
talkmap/
├── .agents/
│ └── plugins/
│ └── marketplace.json
├── plugins/
│ └── talkmap/
│ ├── .codex-plugin/
│ │ └── plugin.json
│ └── skills/
│ └── talkmap/
│ ├── SKILL.md
│ └── references/
│ ├── content-model.md
│ ├── html-document-spec.md
│ └── prototype-guidelines.md
├── README.md
├── README.zh-TW.md
├── LICENSE
├── CHANGELOG.md
├── CONTRIBUTING.md
├── .gitignore
└── examples/
└── product-discussion-input.md
The Codex manifest and marketplace are client-specific packaging. The bundled skills/talkmap/ directory remains portable and avoids client-specific runtime features.
| Client | Distribution | Invocation |
|---|---|---|
| Codex Plugin | GitHub marketplace | Ask normally or select the installed plugin |
| Codex direct Skill | ~/.agents/skills/talkmap |
$talkmap |
| Claude Code | ~/.claude/skills/talkmap |
/talkmap |
| Other Agent Skills clients | Copy the portable skills/talkmap directory |
Client-dependent |
Client behavior and discovery paths can change. Consult the current client documentation when installation behavior differs.
If TalkMap has been helpful to you, please consider sponsoring the project.
Contributions that improve discussion synthesis, decision traceability, cross-domain usefulness, HTML readability, accessibility, or honest interactive explanations are welcome.
See CONTRIBUTING.md.
MIT. See LICENSE.