promptgraph-mcp weekly downloads statistics

PromptGraph

Semantic skill router and marketplace for Claude Code, Claude Desktop, and OpenCode.

Instead of loading every .md skill into context, Claude calls pg_search and loads only the skill it needs — saving 20k+ tokens per session.

---

Features

• Semantic search — BGE-Small-EN embeddings (fastembed), local, no API key required
• Token savings — loads one skill on demand instead of all .md files (~20k+ tokens/session)
• Fast reindex — persistent embed cache makes re-indexing unchanged skills near-instant
• Flexible layouts — finds skills in nested subfolders and in .github/, .claude/, .opencode/ dot-folders (GitHub Copilot / agent conventions)
• Any local folder — pg add-dir <path> indexes a folder that isn't a default source
• Marketplace — browse and install community skill bundles via TUI or MCP tools
• Publishing — publish skills/bundles to the registry hands-off via GitHub CLI
• Multi-platform — verified on Claude Code, Claude Desktop & OpenCode; best-effort config for Cursor, Windsurf, Cline, Codex

---

Install

npm install -g promptgraph-mcp

Quick start

pg setup claude-code      # Claude Code
pg setup opencode         # OpenCode (writes opencode.json MCP config)
pg setup claude-desktop   # Claude Desktop
pg setup cursor           # Cursor

pg setup <platform> does three things:

1. Writes the MCP server config for that platform
2. Sets the skills directory for that platform (e.g. ~/.config/opencode/skills)
3. Runs a full index of your skills

Then restart your editor — the promptgraph MCP server will be available.

---

Supported platforms

Claude Code, Claude Desktop, and OpenCode are verified end-to-end. The others are best-effort — the MCP config path/format is implemented but untested, so pg setup warns before writing. If you run one, please report results.

Platform	Status	Config written	Skills directory
claude-code	✅ verified	~/.claude/settings.json	~/.claude/skills-store
claude-desktop	✅ verified	claude_desktop_config.json (OS-specific)	~/.claude/skills-store
opencode	✅ verified	~/.config/opencode/opencode.json	~/.config/opencode/skills
cursor	⚠️ untested	~/.cursor/mcp.json	~/.cursor/skills
windsurf	⚠️ untested	~/.codeium/windsurf/mcp_config.json	~/.codeium/windsurf/skills
cline	⚠️ untested	~/.vscode/mcp.json	~/.vscode/skills
codex	⚠️ untested	~/.codex/config.json	~/.codex/skills

---

CLI commands

# Setup & maintenance
pg setup <platform>             # Setup MCP config + skills dir for a platform
pg reindex                      # Re-index all skills (progress bar + ETA)
pg status                       # Show index health: sources, skill counts, DB path
pg doctor                       # Check database integrity
pg doctor --reset-dead          # Restore bundles hidden after install errors
pg update                       # Update promptgraph-mcp to latest version

# Search & discovery
pg search <query>               # Semantic search across your skills
pg marketplace                  # Browse community skill bundles (TUI)

# Skill graph
pg plan <skill>                 # DAG execution plan: order, parallel levels, cycle detection
pg duplicates                   # Find near-duplicate / overlapping skills

# Install
pg install <id>                 # Install a skill by marketplace ID (pg-xxxxxx)
pg import <github-url>          # Import skills directly from a GitHub repo URL
pg add-dir <path>               # Index skills from a local folder (any platform)

# Bundles
pg bundle install <id>          # Install a bundle by ID
pg bundle update [repo]         # Pull latest from installed GitHub bundles
pg bundle add-repo <owner/repo> # Publish your GitHub repo to the registry (requires gh)

---

Where your skills can live

PromptGraph scans each registered source folder recursively, so any layout works:

my-skills/
  commit-message.md                  # flat file — name from filename
  refactor/SKILL.md                  # folder skill — name from the folder ("refactor")
  cloud/deploy/SKILL.md              # nested categories — all found
  .github/skills/my-skill/SKILL.md   # GitHub Copilot / agent convention
  .claude/skills/...                 # Claude dot-folder

• Subfolders at any depth are scanned.
• Generic filenames (SKILL.md, index.md, agent.md, …) take their name from the parent folder, so cloud/deploy/SKILL.md and cloud/infra/SKILL.md stay distinct instead of colliding.
• Dot-folders .github/{skills,prompts,agents,commands}, .claude/, .opencode/ are indexed. Other .github paths (workflows, plugins, …) are skipped.
• Doc/meta files (README, CHANGELOG, LICENSE, files in docs/, tests/, assets/, …) are filtered out automatically.

To index a folder that isn't a configured source:

pg add-dir /path/to/skills      # registers it + indexes recursively
pg status                       # confirm it shows up with the right count

---

Data & config location

PromptGraph stores its config, SQLite DB, and ANN index in:

• ~/.promptgraph/ — fresh installs on any platform
• ~/.claude/.promptgraph/ — kept for existing Claude Code installs (not migrated, so the index isn't orphaned)

Your skill files stay wherever you put them (the platform skills dir or any add-dir folder) — only the derived index lives here.

---

Skill orchestration — pg → pg-chain

pg setup installs two router skills:…