src/orchestrator/skills/agent-memory/SKILL.md
Creates, queries agent expertise profiles in AGENT-EXPERTISE.md; increments file-familiarity counters after each task; ranks candidate agents by recency, task-area match. Use when deciding which agent should handle a file, checking who last worked on a module, recording task outcomes, or assigning work based on past performance.
npx skillsauth add monkilabs/opencastle agent-memoryInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Location: .opencastle/AGENT-EXPERTISE.md — one section per agent with Strong Areas, Weak Areas, File Familiarity tables.
Entry format: Area | Evidence | Last Updated — e.g. Server Components | Built TAS-42 | 2026-03-15. File familiarity: - src/lib/search/ — 3 tasks.
| Trigger | Action | |---------|--------| | First-attempt success | Update Strong | | 2+ retries | Update Weak | | File modified | Increment familiarity | | DLQ failure | Add Weak with ref | | >3 months stale | Mark as "stale" |
Query before delegating; include concise context block in prompt:
grep -A5 "## Developer" .opencastle/AGENT-EXPERTISE.md
Example prompt block: Agent Context: Strong — Server Components (3 tasks); Weak — Component styling (2 retries); Familiar — src/lib/search/ (2 tasks)
Update after task completion:
# Append a Strong Area entry
printf '| %s | %s | %s |\n' "Server Components" "Built TAS-42" "$(date +%Y-%m-%d)" >> .opencastle/AGENT-EXPERTISE.md
# Increment file familiarity
awk '/src\/lib\/search\// { if (match($0, /[0-9]+/)) { n = substr($0, RSTART, RLENGTH) + 1; sub(/[0-9]+[[:space:]]*tasks?/, n " tasks") } found=1 } {print} END { if(!found) print "- `src/lib/search/` — 1 task" }' \
.opencastle/AGENT-EXPERTISE.md > tmp && mv tmp .opencastle/AGENT-EXPERTISE.md
.opencastle/AGENT-EXPERTISE.md; check Strong/Weak areas; add concise Agent Context to prompt..opencastle/KNOWLEDGE-GRAPH.md.Prune entries older than 6 months; remove familiarity for deleted paths; consolidate duplicates.
rg "— [0-9]+ tasks" .opencastle/AGENT-EXPERTISE.md after pruning to confirm no stale paths remain.File dependency graph, cross-agent relationships. See KNOWLEDGE-GRAPH.md for entity types, templates, triggers, queries.
development
Defines 10 sequential validation gates: secret scanning, lint/test/build checks, blast radius analysis, dependency auditing, browser testing, cache management, regression checks, smoke tests. Use when running pre-deploy validation or CI checks, CI/CD pipelines, deployment pipeline validation, pre-merge checks, continuous integration, or pull request validation.
development
Generates test plans, writes unit/integration/E2E test files, identifies coverage gaps, flags common testing anti-patterns. Use when writing tests, creating test suites, planning test strategies, mocking dependencies, measuring code coverage, or test planning.
development
Provides model routing rules, validates delegation prerequisites, supplies cost tracking templates, defines dead-letter queue formats for Team Lead orchestration. Load when assigning tasks to agents, choosing model tiers, starting delegation session, running multi-agent workflow, delegating work, choosing which model to use, or assigning tasks.
testing
Saves, restores session state including task progress, file changes, delegation history. Use when saving progress, resuming interrupted work, picking up where you left off, or checkpointing current work.