Roadmap Skill
AI-readable docs: llms.txt · llms-full.txt · ·
接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
AI-readable docs: llms.txt · llms-full.txt · ·
Shared roadmap for humans and AI Agents. Visual kanban and graph for you, Skills and MCP server for Agents. Support Claude Code, Codex, Cursor, OpenCode and more!
ArchitectureShared context — Chat with your Agent to plan tasks, or edit directly in the Kanban — both stay in sync. Your Agent always sees the latest state.
Agent-native — Built as an MCP server. Your AI can create, update, and query tasks directly in conversation.
Visual workspace — Open localhost:7860 when you feel like it, or ask your Agent to open it with open_web_interface. Kanban for status, Graph View for sequencing. Or just stay in chat. All three work.
Local-first — Your data lives on your machine. No accounts, no cloud sync, no vendor lock-in.
Graph View is one of the headline features in v0.3.0.
Kanban is great for tracking status. Graph View is for understanding execution order.
It helps you and your Agent answer questions like:
Instead of treating roadmap tasks as a flat list, Graph View turns them into a visual dependency map with node connections, ready/done states, detailed task cards, and export support. It is designed for planning sessions where sequencing matters just as much as status.
If you are using Roadmap Skill as an MCP workspace, this is the view that makes agent-assisted planning feel concrete: your Agent can build and update dependency graphs in chat, and you can immediately inspect the structure visually in the web UI.
# Integrate with your AI assistant (MCP config below)
claude mcp add roadmap "npx -y roadmap-skill"
{
"mcpServers": {
"roadmap": {
"command": "npx",
"args": ["-y", "roadmap-skill"]
}
}
}
/mcp add
Or edit ~/.copilot/mcp-config.json:
{
"mcpServers": {
"roadmap": {
"type": "local",
"command": "npx",
"args": ["-y", "roadmap-skill"]
}
}
}
{
"mcpServers": {
"roadmap": {
"command": "npx",
"args": ["-y", "roadmap-skill"]
}
}
}
Install Cline plugin, then add to cline_mcp_settings.json:
{
"mcpServers": {
"roadmap": {
"type": "stdio",
"command": "npx",
"args": ["-y", "roadmap-skill"]
}
}
}
{
"mcpServers": {
"roadmap": {
"type": "stdio",
"command": "npx",
"args": ["-y", "roadmap-skill"]
}
}
}
Edit ~/.config/opencode/opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"roadmap": {
"type": "local",
"command": [
"npx",
"-y",
"roadmap-skill"
],
"enabled": true
}
}
}
Go to Settings -> MCP -> Add new MCP Server:
{
"mcpServers": {
"roadmap": {
"command": "npx",
"args": ["-y", "roadmap-skill"]
}
}
}
{
"mcp": {
"servers": {
"roadmap": {
"command": "npx",
"args": ["-y", "roadmap-skill"]
}
}
}
}
Follow Windsurf MCP documentation and use:
{
"mcpServers": {
"roadmap": {
"command": "npx",
"args": ["-y", "roadmap-skill"]
}
}
}
{
"context_servers": {
"roadmap": {
"command": {
"path": "npx",
"args": ["-y", "roadmap-skill"]
}
}
}
}
One-liner (recommended):
codex mcp add roadmap -- npx -y roadmap-skill
Manual config — edit ~/.codex/config.toml:
[mcp_servers.roadmap]
command = "npx"
args = ["-y", "roadmap-skill"]
Windows: No
cmd /cwrapper needed — Codex handles the subprocess directly.
Server name: Must match
^[a-zA-Z0-9_-]+$. Names with spaces or parentheses are rejected.
Note: Both Codex CLI and the Codex VSCode extension share the same
~/.codex/config.toml. A syntax error breaks both.
After setup, simply tell your AI:
"Create a website redesign project with tasks for homepage, about page, and contact form"
The AI will immediately create the project and tasks, saving them to local storage. You can open http://localhost:7860 anytime to view the visual Kanban board.
This repository includes installable skills under skills/, distributed through the git repository rather than the published npm package.
Available skills:
skills/roadmap/ - lightweight background and routing for roadmap-skillskills/roadmap-task-flow/ - capture, enrich, tag, and prioritize roadmap tasksskills/roadmap-planning-views/ - build focused planning graphs from task subsetsskills/roadmap-web-visualization/ - open and use the local roadmap web workspaceRecommended installation pattern for skill-aware tools:
# install from the git repository when the installer supports repo sources
npx skills add shiquda/roadmap-skill
These skills are still in beta. If you run into issues or have suggestions, feedback is very welcome.
Solo developers, AI power users, and vibe coders who want their Agent to be a real collaborator — not just a code generator.
Mid-session, something pops into your head:
"Note this down: switch the auth module to JWT + refresh token rotation"
Use /quick-capture or just say "help me note this down" — your Agent turns it into a task, saves it locally, and you keep going. No context switch, no forgotten ideas.
"This month's OKR is finishing the user system refactor — can you list the related tasks and figure out which ones should come first?"
Use /auto-prioritize to let your Agent analyze the current project state and reorder task priorities accordingly.
"What's left on the current project? Any high-priority tasks I haven't touched yet?"
Or use /suggest-tasks — your Agent recommends the next actions based on current progress and priorities.
Roadmap Skill uses pure local JSON file storage. All data is saved in your user directory:
You can export or import backup files from the web interface.
MIT © shiquda
Shared roadmap for humans and AI Agents. Visual kanban and graph for you, Skills and MCP server for Agents. Support Claude Code, Codex, Cursor, OpenCode and more!
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Roadmap Skill 透過 stdio 在本機執行。
上次檢查時間:2026-10-27。 Shared roadmap for humans and AI Agents. Visual kanban and graph for you, Skills and MCP server for Agents. Support Claude Code, Codex, Cursor, OpenCode and more!