Lifi MCP Skill
holon-run/uxc
Use the LI.FI MCP server through UXC for cross-chain route discovery, bridge/DEX availability checks, token and chain lookup, gas/balance/allowance checks, quote generation, and transfer status…
Teaches the agent to use the state-memory-mcp MCP server to track workflow state, tasks, decisions, blockers, artifacts, plans, milestones, and their semantic relationships in a persistent graph…
Install State Memory MCP
$ npx skills add putervision/state-memory-mcp --skill state-memory-mcp -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install putervision/state-memory-mcp state-memory-mcp --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/putervision/state-memory-mcp.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/state-memory-mcp .claude/skills/state-memory-mcp && rm -rf skills-srcUse ~/.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/
Install the "state-memory-mcp" agent skill from https://github.com/putervision/state-memory-mcp/tree/main/.agents/skills/state-memory-mcp into .claude/skills/state-memory-mcp/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "state-memory-mcp", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/putervision/state-memory-mcp/tree/main/.agents/skills/state-memory-mcpType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add putervision/state-memory-mcp --skill state-memory-mcp -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install putervision/state-memory-mcp state-memory-mcp --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/putervision/state-memory-mcp.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/state-memory-mcp .agents/skills/state-memory-mcp && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "state-memory-mcp" agent skill from https://github.com/putervision/state-memory-mcp/tree/main/.agents/skills/state-memory-mcp into .agents/skills/state-memory-mcp/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "state-memory-mcp", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add putervision/state-memory-mcp --skill state-memory-mcp -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install putervision/state-memory-mcp state-memory-mcp --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/putervision/state-memory-mcp.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/state-memory-mcp .cursor/skills/state-memory-mcp && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "state-memory-mcp" agent skill from https://github.com/putervision/state-memory-mcp/tree/main/.agents/skills/state-memory-mcp into .cursor/skills/state-memory-mcp/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "state-memory-mcp", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/putervision/state-memory-mcp.git --path .agents/skills/state-memory-mcp--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add putervision/state-memory-mcp --skill state-memory-mcp -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install putervision/state-memory-mcp state-memory-mcp --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/putervision/state-memory-mcp.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/state-memory-mcp .gemini/skills/state-memory-mcp && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "state-memory-mcp" agent skill from https://github.com/putervision/state-memory-mcp/tree/main/.agents/skills/state-memory-mcp into .gemini/skills/state-memory-mcp/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "state-memory-mcp", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install putervision/state-memory-mcp state-memory-mcpInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add putervision/state-memory-mcp --skill state-memory-mcp -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/putervision/state-memory-mcp.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/state-memory-mcp .github/skills/state-memory-mcp && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "state-memory-mcp" agent skill from https://github.com/putervision/state-memory-mcp/tree/main/.agents/skills/state-memory-mcp into .github/skills/state-memory-mcp/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "state-memory-mcp", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add putervision/state-memory-mcp --skill state-memory-mcp -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install putervision/state-memory-mcp state-memory-mcp --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/putervision/state-memory-mcp.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/state-memory-mcp .opencode/skills/state-memory-mcp && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "state-memory-mcp" agent skill from https://github.com/putervision/state-memory-mcp/tree/main/.agents/skills/state-memory-mcp into .opencode/skills/state-memory-mcp/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "state-memory-mcp", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
state-memory-mcp- GitHub stars
- 111
- Token cost
- ~1.9k tokens
- SKILL.md length
- 680 words
- Files
- 1
- Skills in repo
- 7
- Repo updated
- First seen
- Licence
- MIT
At a glance
Teaches the agent to use the state-memory-mcp MCP server to track workflow state, tasks, decisions, blockers, artifacts, plans, milestones, and their semantic relationships in a persistent graph…
- Works in 5 steps: Priority Order & Mandatory Checklist → Complete 13 Consolidated MCP Tools… → Node Types & Edge Relationships → …
- Tasks that involve MCP servers
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
- Tasks that involve Project management
What it does
State Memory MCP is an agent skill from putervision/state-memory-mcp. Teaches the agent to use the state-memory-mcp MCP server to track workflow state, tasks, decisions, blockers, artifacts, plans, milestones, and their semantic relationships in a persistent graph database.
Its SKILL.md is about 1.9k 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 Agent Workflows, covering MCP servers and Project management. It works with Model Context Protocol. The repository describes itself as: Persistent, branch-aware workflow state memory MCP server for AI coding assistants. Tracks tasks, accepted decisions, and active blockers to prevent session context bloat and… The licence is MIT.
When your agent uses it
- Tasks that involve MCP servers
- Tasks that involve Project management
Example prompts
- “Use the state-memory-mcp skill to teach the agent to use the state-memory-mcp MCP server to track workflow state, tasks, decisions, blockers…”
- “/state-memory-mcp”
Workflow steps
5 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 0f60ae4. 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 bash).
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
State Memory MCP loads about 1.9k tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 680 words of instructions outside code blocks.
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 putervision/state-memory-mcp at commit 0f60ae4, republished under its MIT licence (© putervision). 680 words, ~1,864 tokens.
Download SKILL.mdSave it as
.claude/skills/state-memory-mcp/SKILL.md (or your agent's skills folder).- name
- state-memory-mcp
- description
- Teaches the agent to use the state-memory-mcp MCP server to track workflow state, tasks, decisions, blockers, artifacts, plans, milestones, and their semantic relationships in a persistent graph database.
State Memory (state-memory-mcp) — 13 Consolidated Tools
This project uses state-memory-mcp with project slug "state-memory-mcp" to provide AI agents with a structured, persistent graph for tracking workflow state.
1. Priority Order & Mandatory Checklist
Before doing any coding or investigation, you MUST run this sequence:
manage_sessions(action: "start")— Start a tracking session with anagent_idfor full change attribution.get_analytics(action: "summary")— Understand current project state, active branches, and overall progress.manage_specs(action: "compliance")— Check real-time requirement coverage matrix and unfulfilled criteria.manage_tasks(action: "next")— Query prioritized runnable tasks (sorted by downstream impact and age).manage_tasks(action: "find_blockers")— Identify any active blockers preventing progress.manage_nodes(action: "list")— Find pending tasks, past decisions, or milestones.query_graph(action: "trace")— Trace what depends on or blocks a task.
2. Complete 13 Consolidated MCP Tools Reference
| # | Tool Name | Key Actions | Description |
|---|---|---|---|
| 1 | manage_nodes | create, update, get, remove, list, search, batch_create, batch_update, add_note | Graph node CRUD, full-text / TF-IDF search, atomic batch operations, and quick notes. |
| 2 | manage_edges | add, remove, batch_add, link_visual | Manage typed graph relationships and link tasks/artifacts to visual memory state IDs. |
| 3 | manage_sessions | start, end, list, bootstrap | Agent tracking sessions, attribution, and single-turn context bootstrapping. |
| 4 | manage_tasks | next, complete, find_blocked, find_stale, find_blockers, find_similar_blockers, auto_prune | Prioritized task queue, task completion, blocker detection, and automated stale pruning. |
| 5 | manage_snapshots | save, list, diff, get_state, revert, undo, get_history | Graph checkpoints, visual diffs, point-in-time state reconstruction, and rollbacks. |
| 6 | manage_specs | scaffold, ingest, export, compliance, verify, decompose_feature, template | Spec-Driven Development (SDD), PRD parsing, acceptance verification, and FDD/RFC templates. |
| 7 | manage_database | backup, restore, audit, merge, branch_diff, branch_merge | SQLite maintenance, physical backups, integrity audits, and Git branch state diffs/merges. |
| 8 | manage_data | export_graph, export_issues, export_trajectories, export_joint_trajectories, export_synergy_metrics, import_graph, import_issues, import_spec | Bulk import/export of graph formats, GitHub/Jira issues, ML trajectories, and ROI synergy metrics. |
| 9 | query_graph | subgraph, trace, raw, natural_language | Graph traversal, upstream/downstream dependency tracing, raw SQL queries, and natural language search. |
| 10 | get_analytics | summary, velocity, burndown, value_metrics, cognitive_load, critical_path, context_snapshot, decision_trail, find_related_decisions, contradictions | Analytics suite: project overview, velocity, burndown, token ROI, cognitive load, and decision trails. |
| 11 | get_events | log, changelog, post_mortem | Append-only event log queries, session changelogs, and automated session post-mortems. |
| 12 | run_diagnostics | validate, doctor, check_refs, audit_chain, compact, archive, prune_events, version | Graph integrity validation, doctor health checks, SHA-256 hash audits, compaction, and archiving. |
| 13 | use_blackboard | post, read | Asynchronous multi-agent notice board for inter-agent coordination with TTL expiration. |
Show full SKILL.md (297 more words)Show less
3. Node Types & Edge Relationships
Node Types:
task— Incremental items of work or coding TODOs.decision— Architectural choices, pattern selections, and rationale.artifact— Files, documentation, or schemas generated by tasks.plan— High-level development specifications and roadmaps.milestone— Progress checkpoints representing grouped sets of tasks.blocker— Impediments or bugs preventing task completion.observation— Contextual findings, notes, or runtime constraints.spec— Feature specification or PRD document container.requirement— Formal functional or non-functional requirement.acceptance_criterion— Testable acceptance criterion for a requirement.visual_state— Visual state link representing UI layout state.
Edge Types:
depends_on— Task/milestone depends on another node.blocks— Blocker stalls a task/milestone.produces— Task/milestone generates an artifact.references— Node references documentation or source files.updates/contradicts— Decision history and conflict tracking.part_of/child_of— Hierarchical groupings (tasks in milestones, milestones in plans).implements/decided_in/satisfies— Links tasks/artifacts to design decisions, plans, or spec requirements.renders_state— Visual memory verification relationship.blocked_by_visual_state— Blocker caused by UI layout failure.verifies/verifies_visual_state— Verification link connecting tests/evidence to requirements.
4. Workflow Patterns
Session Lifecycle:
manage_sessions(action: "start", agent_id: "my-agent")→ getsession_id- Pass
session_idto graph mutations (manage_nodes,manage_edges) manage_sessions(action: "end", session_id: session_id)when work is complete
Task Decomposition:
- Decompose user requests into task nodes with
manage_nodes(action: "create", type: "task", title: "...") - Connect related tasks with
manage_edges(action: "add", type: "depends_on", source_id: A, target_id: B) - Group under milestones with
manage_edges(action: "add", type: "part_of", source_id: task, target_id: milestone)
Codebase Seeding (on first init): If the project has no Plan or Milestone nodes:
- Read README and core files to understand the roadmap and architecture.
- Create a
plannode (e.g., "Project Roadmap") withmanage_nodes(action: "create", type: "plan", title: "..."). - Add
milestonenodes for key phases, connecting withpart_ofedges. - Create
decisionnodes for core technical choices, linking withdecided_inedges.
5. CLI Commands Reference
state-memory-mcp init # Initialize in current project
state-memory-mcp init-global # Re-initialize across all projects in ~/.state-memory-mcp/projects.json
state-memory-mcp run # Stdio MCP server (used by IDEs)
state-memory-mcp inspect -p X # ASCII table of project nodes
state-memory-mcp metrics -p X # ROI and token savings analytics
state-memory-mcp view -p X # Open 3D graph visualizer in browser
state-memory-mcp export -p X -f [json|dot|mermaid|html] # Export graph
state-memory-mcp scan-git -p X # Incrementally scan git history
state-memory-mcp backup -p X # Back up the database
state-memory-mcp audit -p X # Run integrity checks
state-memory-mcp doctor # Verify system health and SQLite environment© putervision, 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 .agents/skills/state-memory-mcp of putervision/state-memory-mcp.
Open the folder on GitHubat commit 0f60ae4
Compare with similar skills
State Memory MCP 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| State Memory MCP this skillputervision/state-memory-mcp | 111 | — | ~1.9k | Automated safety check: Pass | MIT | |
| Lifi MCP Skillholon-run/uxc | 115 | — | ~1.2k | Automated safety check: Pass | MIT | |
| Patsnap Drug Assetpatsnap/mcp | 112 | — | ~653 | Automated safety check: Pass | Apache-2.0 | |
| Jira Natural Language Interfacejjmartres/opencode | 133 | 3 repos | ~1.7k | Automated safety check: Pass | MIT | |
| GitHub Issuesgithub/awesome-copilot | 40k | 2 repos | ~2.3k | Automated safety check: Pass | MIT | |
| Ot Cost Analysisaiskillstore/marketplace | 430 | — | ~4.4k | Automated safety check: Pass | None |
Similar skills
Patsnap Drug Asset
patsnap/mcp
Patsnap Drug & Asset MCP for AI agents. An agent skill from patsnap/mcp.
Jira Natural Language Interface
jjmartres/opencode
Lets an agent view, create, update and transition Jira issues in natural language, automatically choosing between the jira CLI and Atlassian MCP tools.
- Official
GitHub Issues
github/awesome-copilot
Create, update, and manage GitHub issues using MCP tools. An agent skill from github/awesome-copilot.
Ot Cost Analysis
aiskillstore/marketplace
Trigger for: Other Transaction or OT should-cost, cost estimate, cost-share analysis, milestone pricing, funding profile, proposed-price comparison, prototype price analysis, research OT budget…
Linear
AlexAI-MCP/hermes-CCC
Linear project management — create issues, manage cycles, update projects, and query team progress via Linear API or MCP.
More from putervision/state-memory-mcp
Behavior MCP
putervision/state-memory-mcp
Teaches the agent to use the Behavior MCP server for ~60Hz in-browser behavior trees, triggers, and recordings.
Video Ingest
putervision/state-memory-mcp
Teaches the agent to process, ingest, analyze, and compare WebM, MP4, and GIF video recordings using vision-memory-mcp and state-memory-mcp.
Webcrypt MCP
putervision/state-memory-mcp
Teaches the agent to use the WebCrypt MCP server for AES-256-GCM symmetric encryption, RSA-4096 hybrid encryption, key generation, digital signatures, hashing, and post-quantum cryptography.
Agent Reasoning MCP
putervision/state-memory-mcp
Teaches the agent to use the Strategic Agent Reasoning MCP server for BDI goals, utility scoring, risk evaluation, and replanning.
Vision Memory MCP
putervision/state-memory-mcp
Teaches the agent to use the Visual Memory MCP server to cache webpage and application screenshots, matching layout states and avoiding redundant LLM vision calls.
World Model MCP
putervision/state-memory-mcp
Teaches the agent to use the Spatial World Model MCP server to track entities, 3D/2D positions, spatial relationships, object permanence, and movement simulation.
Related
Works with
Categories
Questions about State Memory MCP
What does State Memory MCP do?
Teaches the agent to use the state-memory-mcp MCP server to track workflow state, tasks, decisions, blockers, artifacts, plans, milestones, and their semantic relationships in a persistent graph…. State Memory MCP is an agent skill from putervision/state-memory-mcp. Teaches the agent to use the state-memory-mcp MCP server to track workflow state, tasks, decisions, blockers, artifacts, plans, milestones, and their semantic relationships in a persistent graph database.
When should I use State Memory MCP?
State Memory MCP fits situations like: tasks that involve MCP servers; tasks that involve Project management.
How do I install State Memory MCP in Claude Code?
Run `npx skills add putervision/state-memory-mcp --skill state-memory-mcp -a claude-code`. Or copy the skill folder (.agents/skills/state-memory-mcp in putervision/state-memory-mcp) into .claude/skills/state-memory-mcp in your project. Claude Code loads it when a task matches its description.
How do I install State Memory MCP in Codex?
Run `npx skills add putervision/state-memory-mcp --skill state-memory-mcp -a codex`. Or copy the skill folder (.agents/skills/state-memory-mcp in putervision/state-memory-mcp) into .agents/skills/state-memory-mcp in your project. Codex loads it when a task matches its description.
Can I use State Memory MCP 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 putervision/state-memory-mcp --skill state-memory-mcp -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/state-memory-mcp, .gemini/skills/state-memory-mcp, .github/skills/state-memory-mcp and .opencode/skills/state-memory-mcp in your project.
What does State Memory MCP need to run?
SKILL.md names no scripts, command-line tools or credentials: State Memory MCP is instructions for the agent only.
Does State Memory MCP 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 State Memory MCP 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 State Memory MCP use?
State Memory MCP 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 State Memory MCP use?
About 1.9k tokens (SKILL.md is roughly 7.5k 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 State Memory MCP?
Skills that share tags, products or a category with State Memory MCP: Lifi MCP Skill (holon-run/uxc, 115 stars), Patsnap Drug Asset (patsnap/mcp, 112 stars), Jira Natural Language Interface (jjmartres/opencode, 133 stars) and GitHub Issues (github/awesome-copilot, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains State Memory MCP?
putervision (a GitHub organization) maintains it in putervision/state-memory-mcp, which has 111 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 3, 2026.
Source: putervision/state-memory-mcp on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.