Skip to content

Solution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors

Rust

Improve skill trigger descriptions

Thiago Silvaa6bfa584e55b
diff --git a/crates/ai-memory-core/src/routing_skills.rs b/crates/ai-memory-core/src/routing_skills.rs
index af971ecf..7092527a 100644
--- a/crates/ai-memory-core/src/routing_skills.rs
+++ b/crates/ai-memory-core/src/routing_skills.rs
@@ -6,11 +6,11 @@
/// Stable ownership marker embedded in every managed ai-memory skill file.
pub const MANAGED_MARKER: &str = "<!-- ai-memory-managed: routing-skill -->";
-const RETRIEVAL_DESCRIPTION: &str = "Use when the user asks to search memory, catch up, inspect recent activity, read wiki pages, get ai-memory stats, query prior decisions, or apply remembered rules before design or debugging.";
-const HANDOFF_DESCRIPTION: &str = "Use when the user asks where we left off, whether there is a pending handoff, to save context for the next session, to end or wrap up a session, or to discard a mistaken handoff.";
-const DURABLE_PAGES_DESCRIPTION: &str = "Use when the user explicitly asks to remember something permanently, save a durable project note, add an annotation, create a wiki page, delete a memory page, or record a project rule.";
-const LEARNING_MAINTENANCE_DESCRIPTION: &str = "Use when the user asks to consolidate memory, review what was learned, propose durable lessons, audit the wiki, find contradictions, prune old memory, or run auto-improvement maintenance.";
-const ROUTING_INSTALL_DESCRIPTION: &str = "Use when the user asks to install, refresh, update, repair, or remove ai-memory routing instructions or Agent Skills in CLAUDE.md, AGENTS.md, .claude/skills, or .agents/skills.";
+const RETRIEVAL_DESCRIPTION: &str = "Use this skill for any request whose goal is read-only retrieval from ai-memory: project history, prior context, decisions, rules, gotchas, recent activity, full wiki pages, or status/briefing. Trigger by semantic intent rather than exact wording, including when ai-memory is not named.";
+const HANDOFF_DESCRIPTION: &str = "Use this skill for any request whose goal is session continuity across agents or time: finding a pending handoff, resuming previous work, saving next-session context, wrapping up, or discarding a mistaken handoff. Trigger by semantic intent rather than exact wording.";
+const DURABLE_PAGES_DESCRIPTION: &str = "Use this skill for any explicit durable wiki mutation in ai-memory: saving project knowledge, recording a rule or annotation, updating a permanent note, or deleting a memory page. Trigger by semantic intent rather than exact wording; routine session capture is not a durable-page request.";
+const LEARNING_MAINTENANCE_DESCRIPTION: &str = "Use this skill for any ai-memory knowledge-base maintenance request: consolidating observations, reviewing session lessons, proposing durable learnings, auditing or linting the wiki, finding contradictions, pruning stale memory, or running auto-improvement. Trigger by semantic intent rather than exact wording.";
+const ROUTING_INSTALL_DESCRIPTION: &str = "Use this skill for any request to install, refresh, repair, inspect, or remove ai-memory's agent-facing routing: managed instruction snippets, Agent Skills, CLAUDE.md/AGENTS.md integration, or local/global skill roots. Trigger by semantic intent rather than exact wording.";
/// One ai-memory-managed Agent Skill file bundled by the core crate.
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
diff --git a/crates/ai-memory-core/src/routing_skills/ai-memory-durable-pages/SKILL.md b/crates/ai-memory-core/src/routing_skills/ai-memory-durable-pages/SKILL.md
index a1ae60d6..fb439cdf 100644
--- a/crates/ai-memory-core/src/routing_skills/ai-memory-durable-pages/SKILL.md
+++ b/crates/ai-memory-core/src/routing_skills/ai-memory-durable-pages/SKILL.md
@@ -1,6 +1,6 @@
---
name: ai-memory-durable-pages
-description: Use when the user explicitly asks to remember something permanently, save a durable project note, add an annotation, create a wiki page, delete a memory page, or record a project rule.
+description: Use this skill for any explicit durable wiki mutation in ai-memory: saving project knowledge, recording a rule or annotation, updating a permanent note, or deleting a memory page. Trigger by semantic intent rather than exact wording; routine session capture is not a durable-page request.
---
<!-- ai-memory-managed: routing-skill -->
diff --git a/crates/ai-memory-core/src/routing_skills/ai-memory-handoff/SKILL.md b/crates/ai-memory-core/src/routing_skills/ai-memory-handoff/SKILL.md
index 707e0036..c362f2e8 100644
--- a/crates/ai-memory-core/src/routing_skills/ai-memory-handoff/SKILL.md
+++ b/crates/ai-memory-core/src/routing_skills/ai-memory-handoff/SKILL.md
@@ -1,6 +1,6 @@
---
name: ai-memory-handoff
-description: Use when the user asks where we left off, whether there is a pending handoff, to save context for the next session, to end or wrap up a session, or to discard a mistaken handoff.
+description: Use this skill for any request whose goal is session continuity across agents or time: finding a pending handoff, resuming previous work, saving next-session context, wrapping up, or discarding a mistaken handoff. Trigger by semantic intent rather than exact wording.
---
<!-- ai-memory-managed: routing-skill -->
diff --git a/crates/ai-memory-core/src/routing_skills/ai-memory-learning-maintenance/SKILL.md b/crates/ai-memory-core/src/routing_skills/ai-memory-learning-maintenance/SKILL.md
index 44f10380..875a74aa 100644
--- a/crates/ai-memory-core/src/routing_skills/ai-memory-learning-maintenance/SKILL.md
+++ b/crates/ai-memory-core/src/routing_skills/ai-memory-learning-maintenance/SKILL.md
@@ -1,6 +1,6 @@
---
name: ai-memory-learning-maintenance
-description: Use when the user asks to consolidate memory, review what was learned, propose durable lessons, audit the wiki, find contradictions, prune old memory, or run auto-improvement maintenance.
+description: Use this skill for any ai-memory knowledge-base maintenance request: consolidating observations, reviewing session lessons, proposing durable learnings, auditing or linting the wiki, finding contradictions, pruning stale memory, or running auto-improvement. Trigger by semantic intent rather than exact wording.
---
<!-- ai-memory-managed: routing-skill -->
diff --git a/crates/ai-memory-core/src/routing_skills/ai-memory-retrieval/SKILL.md b/crates/ai-memory-core/src/routing_skills/ai-memory-retrieval/SKILL.md
index 814827ba..3ed303f1 100644
--- a/crates/ai-memory-core/src/routing_skills/ai-memory-retrieval/SKILL.md
+++ b/crates/ai-memory-core/src/routing_skills/ai-memory-retrieval/SKILL.md
@@ -1,6 +1,6 @@
---
name: ai-memory-retrieval
-description: Use when the user asks to search memory, catch up, inspect recent activity, read wiki pages, get ai-memory stats, query prior decisions, or apply remembered rules before design or debugging.
+description: Use this skill for any request whose goal is read-only retrieval from ai-memory: project history, prior context, decisions, rules, gotchas, recent activity, full wiki pages, or status/briefing. Trigger by semantic intent rather than exact wording, including when ai-memory is not named.
---
<!-- ai-memory-managed: routing-skill -->
diff --git a/crates/ai-memory-core/src/routing_skills/ai-memory-routing-install/SKILL.md b/crates/ai-memory-core/src/routing_skills/ai-memory-routing-install/SKILL.md
index bbb119e9..03563029 100644
--- a/crates/ai-memory-core/src/routing_skills/ai-memory-routing-install/SKILL.md
+++ b/crates/ai-memory-core/src/routing_skills/ai-memory-routing-install/SKILL.md
@@ -1,6 +1,6 @@
---
name: ai-memory-routing-install
-description: Use when the user asks to install, refresh, update, repair, or remove ai-memory routing instructions or Agent Skills in CLAUDE.md, AGENTS.md, .claude/skills, or .agents/skills.
+description: Use this skill for any request to install, refresh, repair, inspect, or remove ai-memory's agent-facing routing: managed instruction snippets, Agent Skills, CLAUDE.md/AGENTS.md integration, or local/global skill roots. Trigger by semantic intent rather than exact wording.
---
<!-- ai-memory-managed: routing-skill -->