adrozdenko/soleri-agent-mode
packages/forge/src/skills/soleri-agent-mode/SKILL.md
Triggers: "AgentName, ...", "Hey AgentName", "what commands do I have", "what can you do with MCP", "command reference". Routes ambiguous intent to correct facade + op. Also handles vague phrases like "save this", "remember this", "search for patterns".
$ install --global
skillsauthnpx skillsauth add adrozdenko/soleri soleri-agent-modeInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 15, 2026, 6:31 PM174.5s1 file scanned
SKILL.md
- name:
- soleri-agent-mode
- tier:
- default
- description:
- Triggers: "AgentName, ...", "Hey AgentName", "what commands do I have", "what can you do with MCP", "command reference". Routes ambiguous intent to correct facade + op. Also handles vague phrases like "save this", "remember this", "search for patterns".
Agent Mode — Intent Routing & Command Reference
This skill governs how to interpret natural language directed at this agent and route it to the correct facade + op. Use it when a phrase is ambiguous, when the user addresses the agent directly, or when surfacing the command reference.
Routing Protocol (MANDATORY)
Before executing any agent op, apply this 3-step protocol:
Step 1 — Semantic parse Identify the verb + object in the user's message:
- Verb: what action? (search, save, plan, execute, remember, check, show, run, fix)
- Object: what is it about? (vault, brain, memory, plan, session, health, pattern)
Step 2 — Confirm via route_intent (when ambiguous)
YOUR_AGENT_control op:route_intent
params: { input: "<user's phrase>", context: "<current task context>" }
Use this when the phrase matches 2+ intents. Skip it for obvious, unambiguous commands.
Step 3 — Execute the mapped op
Use the NL → Op table below to select facade + op. Pass projectPath: "." wherever required.
Natural Language → Facade + Op Mapping
Search & Recall
| What the user says | Facade | Op | Notes |
| ------------------------------------------ | ------------------- | -------------------- | ------------------------ |
| "search for X" / "find patterns on X" | YOUR_AGENT_vault | search_intelligent | mode: "scan" first |
| "what do we know about X" | YOUR_AGENT_vault | search_intelligent | mode: "full" if specific |
| "recall X" / "remember X from before" | YOUR_AGENT_memory | memory_search | crossProject if broad |
| "what patterns are strong" | YOUR_AGENT_brain | brain_strengths | days: 30 default |
| "recommend something" / "what should I do" | YOUR_AGENT_brain | brain_recommend | |
| "show me vault entries about X" | YOUR_AGENT_vault | load_entries | after scan |
| "what's in the vault" | YOUR_AGENT_vault | vault_stats | |
Save & Capture
| What the user says | Facade | Op | Notes |
| ----------------------------------------------- | ------------------- | ------------------- | --------------------- |
| "save this" / "capture this" (detailed pattern) | YOUR_AGENT_vault | capture_knowledge | full structured entry |
| "quick save" / "jot this down" | YOUR_AGENT_vault | capture_quick | lightweight, fast |
| "remember this for the session" | YOUR_AGENT_memory | memory_capture | session-scoped |
| "save the session" / "log what we did" | YOUR_AGENT_memory | session_capture | end-of-session |
| "ingest this URL" / "add this article" | YOUR_AGENT_vault | ingest_url | external content |
| "ingest this text" | YOUR_AGENT_vault | ingest_text | raw text |
Planning
| What the user says | Facade | Op | Notes |
| ---------------------------------------- | ----------------- | ------------------------- | --------------------- |
| "create a plan" / "plan this" | YOUR_AGENT_plan | create_plan | MANDATORY before code |
| "approve the plan" / "looks good" | YOUR_AGENT_plan | approve_plan | Gate 1 |
| "split the plan" / "break it into tasks" | YOUR_AGENT_plan | plan_split | Gate 2 |
| "check plan drift" / "what changed" | YOUR_AGENT_plan | plan_reconcile | post-execution |
| "complete the plan" / "close it out" | YOUR_AGENT_plan | plan_complete_lifecycle | final step |
| "list active plans" | YOUR_AGENT_plan | chain_list | |
Orchestration
| What the user says | Facade | Op | Notes |
| ----------------------------------------------- | ------------------------ | ---------------------- | ---------------------------- |
| "orchestrate this" / "AgentName, orchestrate X" | YOUR_AGENT_orchestrate | orchestrate_plan | vault+brain+plan in one call |
| "execute the plan" / "start executing" | YOUR_AGENT_orchestrate | orchestrate_execute | tracks progress |
| "finish up" / "wrap the session" | YOUR_AGENT_orchestrate | orchestrate_complete | epilogue: vault + session |
Brain & Learning
| What the user says | Facade | Op | Notes |
| -------------------------------------------- | ------------------ | -------------------- | -------------------- |
| "what has the brain learned" / "brain stats" | YOUR_AGENT_brain | brain_stats | |
| "give feedback on that" | YOUR_AGENT_brain | brain_feedback | reinforcement signal |
| "what patterns are failing" | YOUR_AGENT_brain | brain_decay_report | |
| "radar analysis" / "spot patterns" | YOUR_AGENT_brain | radar_analyze | |
| "show radar candidates" | YOUR_AGENT_brain | radar_candidates | |
Health & Admin
| What the user says | Facade | Op | Notes |
| ------------------------------------------- | -------------------- | ------------------ | ----- |
| "health check" / "is everything working" | YOUR_AGENT_admin | admin_health | |
| "list all tools" / "what tools do you have" | YOUR_AGENT_admin | admin_tool_list | |
| "session briefing" / "catch me up" | YOUR_AGENT_admin | session_briefing | |
| "diagnose X" | YOUR_AGENT_admin | admin_diagnostic | |
| "run routing accuracy" | YOUR_AGENT_control | routing_accuracy | |
Vault Maintenance
| What the user says | Facade | Op | Notes |
| ---------------------------------- | -------------------- | --------------------------- | ----- |
| "clean the vault" / "groom" | YOUR_AGENT_curator | curator_groom | |
| "find duplicates" | YOUR_AGENT_curator | curator_detect_duplicates | |
| "vault health audit" | YOUR_AGENT_curator | curator_health_audit | |
| "archive old entries" | YOUR_AGENT_vault | vault_archive | |
| "push vault to git" / "sync vault" | YOUR_AGENT_vault | vault_git_push | |
Identity & Control
| What the user says | Facade | Op | Notes |
| ----------------------------------- | -------------------- | -------------------- | ------------------------ |
| "Hello, AgentName!" / activate | YOUR_AGENT_core | activate | params: projectPath |
| "Goodbye, AgentName!" / deactivate | YOUR_AGENT_core | activate | params: deactivate: true |
| "who are you" / "what mode is this" | YOUR_AGENT_core | identity | |
| "register this project" | YOUR_AGENT_core | register | params: projectPath |
| "route this intent" | YOUR_AGENT_control | route_intent | |
| "switch mode" / "morph to X" | YOUR_AGENT_control | morph | |
| "what are the behavior rules" | YOUR_AGENT_control | get_behavior_rules | |
Disambiguation Matrix
These phrases are ambiguous — resolve using context signals:
| Phrase | Context signal | Route to |
| --------------- | ---------------------------------------- | ---------------------------------------- |
| "save this" | Detailed explanation, pattern discussion | vault.capture_knowledge |
| "save this" | Quick note, side comment | vault.capture_quick |
| "save this" | "For this session only" | memory.memory_capture |
| "remember this" | Repeatable rule or pattern | vault.capture_knowledge |
| "remember this" | Session-scoped fact | memory.memory_capture |
| "search for X" | Broad/exploratory | vault.search_intelligent mode:scan |
| "search for X" | Specific known entry | vault.search_intelligent mode:full |
| "search for X" | Across past sessions | memory.memory_search crossProject:true |
| "check this" | Code/PR in context | → deep-review skill |
| "check this" | System health | admin.admin_health |
| "plan this" | Work task | orchestrate.orchestrate_plan |
| "plan this" | User wants to see plan first | plan.create_plan |
Resolution rule: When still ambiguous after checking context signals, ask one clarifying question before routing. Never guess and execute a write op.
"AgentName, orchestrate X" — Full Flow
When the user says "AgentName, orchestrate [task description]":
YOUR_AGENT_orchestrate op:orchestrate_plan— vault lookup + brain recommendations + structured plan in one call- Present the plan using the standard Plan Presentation format (Plan ID, Check ID, Grade, Status)
- Wait for Gate 1 approval: "approve" / "yes" / "looks good"
YOUR_AGENT_plan op:plan_split— decompose into tasks- Wait for Gate 2 approval
YOUR_AGENT_orchestrate op:orchestrate_execute— track execution per taskYOUR_AGENT_orchestrate op:orchestrate_complete— epilogue: vault capture + session record
Never skip Gate 1 or Gate 2. Never proceed past a gate without explicit user approval.
Anti-Patterns
- Guessing a write op — if "save this" is ambiguous, ask before writing to vault
- Skipping route_intent for ambiguous phrases — use it to confirm, not as a formality
- Executing orchestrate_plan without showing the plan — always present before Gate 1
- Using memory_capture for reusable patterns — session memory ≠ vault knowledge
- Ignoring the two-pass vault search — scan first, load only top 2-4 results
Related Skills
adrozdenko/soleri-terse
testing
VerifiedTrustedCommunity
Triggers: "terse mode", "be brief", "less tokens", "fewer tokens", "compress output", "caveman", or invokes /terse. Token-efficient responses with full technical accuracy.
6SKILL.mdUpdated Apr 15, 2026
adrozdenko/soleri-compress
tools
VerifiedTrustedCommunity
Triggers: "compress this file", "compress CLAUDE.md", "compress memory", "shrink this", "reduce tokens in file", or invokes /compress. Compresses natural language files to save input tokens.
6SKILL.mdUpdated Apr 15, 2026
adrozdenko/soleri-release
testing
VerifiedTrustedCommunity
Triggers: "release", "bump version", "publish packages", "cut a release", "version bump", "npm publish". Bumps monorepo versions, commits, tags, pushes to trigger CI release. Use deliver-and-ship for quality gates.
6SKILL.mdUpdated Apr 10, 2026
adrozdenko/soleri-orchestrate
development
VerifiedTrustedCommunity
Triggers: "implement X", "build Y", "fix Z", "add feature", or any work task needing planning + execution. Full orchestration loop: plan, execute, complete with vault context and brain recs.
6SKILL.mdUpdated Apr 10, 2026