Tools & Skills

MCP tools for graph operations and skills for procedural guidance.

How it works: External agents call MCP tools to read and write your graph. For complex tasks, they read skills (listSkills/readSkill) to follow your preferred operating patterns.

MCP Tools

RA-OS exposes these core standalone MCP tools:

Context + Graph

Tool	Description
`getContext`	Graph overview: stats, contexts, hub nodes, dimensions, recent activity, skills
`queryNodes`	Search nodes by keyword/dimensions/date
`getNodesById`	Fetch full nodes by ID
`createNode`	Create a node
`updateNode`	Update a node
`createEdge`	Create an edge between nodes
`queryEdge`	Query edges
`updateEdge`	Update edge explanation
`queryDimensions`	List dimensions
`createDimension`	Create a dimension
`updateDimension`	Update/rename a dimension
`deleteDimension`	Delete a dimension

Skills + Search

Tool	Description
`listSkills`	List available skills
`readSkill`	Read one skill
`writeSkill`	Create/update a skill
`deleteSkill`	Delete a skill
`searchContentEmbeddings`	Search source chunks/transcripts
`sqliteQuery`	Read-only SQL (`SELECT`, `WITH`, `PRAGMA`)

Skills

Skills are markdown instructions stored locally and shared across internal + external agents.

Default seeded skills

db-operations
create-skill
audit
traverse
onboarding
persona
calibration
connect

Storage

Live skills: ~/Library/Application Support/RA-H/skills/
Bundled defaults: src/config/skills/

API Routes

Route	Method	Purpose
`/api/skills`	GET	List skills
`/api/skills/[name]`	GET/PUT/DELETE	Skill CRUD
`/api/guides`	GET	Compatibility alias to skills
`/api/guides/[name]`	GET/PUT/DELETE	Compatibility alias to skills

Key Files

File	Purpose
`apps/mcp-server-standalone/`	Standalone MCP server (recommended)
`src/services/skills/skillService.ts`	Skills runtime service
`src/config/skills/*.md`	Bundled default skills
`src/components/panes/SkillsPane.tsx`	Skills pane UI

2.2 KiB Raw Blame History