agent-memory

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.

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./src/orchestrator/skills/agent-memory/SKILL.md

Agent Memory Protocol

Expertise File

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.

Update Triggers

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"

Retrieval & Delegation

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

After each task also append file relationships to .opencastle/KNOWLEDGE-GRAPH.md. On DLQ failure, the Weak Area entry must carry the failure ID and a link to its logs.

Validation Checkpoints

Before delegating: chosen agent has a Strong area matching the task and no conflicting Weak entry.
After completion: expertise file has the new entry, timestamped today.
After pruning: rg "— [0-9]+ tasks" .opencastle/AGENT-EXPERTISE.md shows no stale paths.

Pruning

Prune entries older than 6 months; remove familiarity for deleted paths; consolidate duplicates.

Knowledge Graph

File dependency graph, cross-agent relationships. See KNOWLEDGE-GRAPH.md for entity types, templates, triggers, queries.

Repository: monkilabs/opencastle
Path: src/orchestrator/skills/agent-memory/SKILL.md
Commit: fa0c341

Last updated: 5 days ago
First committed: 5 months ago

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.