Skills, tools & MCP

Convention over registration. Drop a file in the right folder and it exists. Tools are scripts; skills are agent playbooks (optional MCP); memory is markdown the agent can search.

PrerequisiteA train folder

aq tool <name>

Run tools/<name>.{py,ts,js,sh} with cwd = train and AQ_TRAIN set.

example

$aq tool

example

$aq tool summarize -- --limit 10

skills/

Agent skills: .md or a directory with SKILL.md, optional run.py, optional mcp.json. Agent tools: skills_search, skill_load, skill_run. MCP servers become mcp_<skill>_<tool>.

example

 # skills/hash-first/SKILL.md # skills/hash-first/run.py # skills/hash-first/mcp.json

memory/

Agent-searchable markdown notes for this train.

example

$memory/notes.md