SuperSkill
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| VAULT_PATH | No | Path to knowledge vault | ~/Vaults/ai |
| MAX_INJECT_TOKENS | No | Max tokens for context injection | 1500 |
| SESSION_TTL_HOURS | No | Session heartbeat TTL | 2 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
| prompts | {} |
| resources | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| readA | Read a file or directory listing from the AI knowledge vault. |
| writeB | Write or append to a file in the AI knowledge vault. |
| searchA | Full-text search (SQLite FTS5 porter stemming) scoped to this project. Structured mode still matches frontmatter. |
| project_contextA | Get the context document for a project. Auto-detects project from CWD if not specified. |
| generate_contextA | Scan a git repo and generate a draft context.md. Returns the draft — does NOT write to vault. Human reviews before committing. |
| decideB | Log an architectural/design decision to the project's decisions directory. |
| taskA | Manage project tasks. Supports add, list, update, and board (kanban) views. Tasks are stored as individual files in projects//tasks/. |
| learnA | Capture and query learnings. Learnings persist discoveries across sessions. Stored as individual files in projects//learnings/. |
| brainstormC | Start or continue a brainstorm document for a project. |
| sessionA | Register, update, or query active agent sessions for multi-agent coordination. On complete, persists a session note to the vault. |
| pruneA | Archive or delete stale vault content based on retention policies. Use mode='dry-run' first to preview. |
| statsA | Show content statistics for a project — file counts, task breakdown, growth monitoring. |
| resumeA | Get resume context for continuing work — recent sessions, interrupted work, in-progress tasks, suggested next steps. Call this at session start to understand what happened before. |
| deprecateA | Mark a vault item (ADR, learning, etc.) as deprecated with an optional reason. |
| initA | Initialize superskill for the current project. Detects stack, indexes the in-repo catalog, builds the knowledge graph. Does not scrape skills.sh. |
| statusA | Show superskill knowledge graph state: loaded skills, weights, recent sessions. |
| superskillA | Route a task to curated in-repo packs (code/review/security/ops/devops). Lazy: only matching language + phase. Does not scrape skills.sh. |
| skill_installA | Install skills from a GitHub repo (e.g. owner/repo or full URL). Clones the repo, discovers SKILL.md files, and copies them to the local skill directory. |
| skill_list_installedA | List skills installed locally from GitHub repos. |
| skill_removeA | Remove an installed skill by name. |
| linkA | Create a forward link between two vault notes. Appends a [[wikilink]] to the source note, enabling graph_related to discover the connection. |
| extractA | Extract decisions, learnings, or other items from a source document into individual vault files. Each extracted item gets its own file with a backlink to the source. |
| graph_relatedA | Related notes via the FTS/edge index (related frontmatter + wikilinks), jailed to this project. |
| knowledge_rebuildA | Rebuild this project's SQLite FTS5 + edges index from markdown. Source of truth stays the files. |
| knowledge_vizB | Write knowledge-graph.html (browser) and knowledge-graph.canvas (open in Obsidian). Same edges as the FTS index. |
| qa_vizC | Regenerate the knowledge graph HTML and drive system Chrome to click nodes and read the panel. In-harness QA, not a plugin. |
| graph_cross_projectA | Search the current project's vault only. Cross-project search is denied. |
| snapshot_repo_stateA | Snapshot current git state (branch, dirty files, last commit) into the vault. Helps avoid repeating repo discovery across sessions. |
| env_factsA | Store and query stable environment facts for a project (e.g., auth backend, env file locations, local URLs, required env vars). Not for secrets — use cred_refs for that. |
| cred_refsA | Store pointers to where credentials are documented (not the credentials themselves). E.g., 'Django admin creds are in tests/live/test_all_endpoints.py'. |
| rollbackA | Manage rollback checkpoints. Store commit hashes with purpose/scope so rollback is safer. Mark when follow-up work starts after a checkpoint. |
| captureA | Batch-capture multiple insights from a conversation into individual vault items. Each item gets its own file with auto-numbering. Supports any content type (learning, decision, adr, prd, research, etc.). |
| templateA | Get pre-filled templates for common vault item types (adr, prd, decision, learning, spec, rfc, roadmap, competitive-analysis, incident, research, vision, strategy). Use to scaffold new documents. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| inject-project-context | Returns a system prompt fragment with project context, recent decisions, and active todos. |
| summarize-session | Returns a prompt guiding the agent to produce a structured session summary. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Active Sessions | Currently active agent sessions across all tools |
TDQS
Scored across 33 tools
Most tools have distinct purposes, but several pairs blur together: qa_viz redoes knowledge_viz's HTML generation, graph_cross_project reads like a search tool rather than a cross-project graph tool, and capture/learn/extract all create vault items. The descriptions are detailed enough to disambiguate many cases, but a few boundaries are genuinely unclear.
All names use snake_case and are readable, but there is no consistent verb_noun or noun_verb convention: generate_context/search are verb-led, skill_install is noun+verb, skill_list_installed reverses the pattern, and status/task/template are bare nouns. qa_viz and superskill add product-specific abbreviations/names that don't fit the rest.
33 tools is too many for a single server's tool surface; the set spans knowledge vault CRUD, graph visualization, skill management, sessions, env facts, and rollback checkpoints. Several tools could be consolidated (knowledge_viz/qa_viz) or split into separate servers, and the volume makes selection harder.
The surface covers creation, reading, updating (via write), archival/deletion (prune/deprecate), plus specialized lifecycle tools for skills, sessions, tasks, and learnings. Notable minor gaps include no dedicated skill update, no unlink, and no explicit list/query for decisions, though search/read can work around them.