xoai/sage
tools/sage-claude-plugin/skills/sage/SKILL.md
Start here. Sage reads project state, routes via keywords, classifies intent, and guides you to the right workflow.
$ install --global
skillsauthnpx skillsauth add xoai/sage sageInstall 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 26, 2026, 2:09 AM120.7s1 file scanned
SKILL.md
- name:
- sage
- description:
- >
- disable-model-invocation:
- true
RULES (apply to every step — non-negotiable):
- Present project state with "Sage:" prefix
- Present options with [1] [2] [3] bracket notation — ALWAYS
- Recommend a specific workflow for Standard+ tasks
- NEVER just ask "What would you like to do?" — present structured choices
- Never use code blocks for interaction output
Sage's intelligent entry point. Assess the project and guide the user.
Step 1: Read State
Scan .sage/work/ for active initiatives (read frontmatter: title,
status, phase). Scan .sage/docs/ for project-level artifacts.
Read .sage/decisions.md for recent context.
Step 2: Present Status and Options
Present what you found, then structured options based on context.
If work is in progress:
Sage: [Project name] — [feature] is in progress, [phase] phase.
[1] Continue [feature] — resume from [next step] [2] Start something new [3] Review what's been done
If no work in progress but artifacts exist:
Sage: [Project name] — no active work. Previous: [list initiatives].
[1] Start a new task — describe what you want to build [2] Review existing artifacts [3] Learn the codebase
If fresh project:
Sage: Fresh project, no work in progress.
[1] Build something — describe what you want to create [2] Learn the codebase first [3] Something else — describe what you need
Step 3: Route to Workflow
Based on user's choice or free-form input, classify scope and route:
- Lightweight → just do it
- Standard → announce build/fix workflow, start first step
- Comprehensive → present architect workflow card
For complex routing or gap detection, read the sage-navigator at
sage/core/capabilities/orchestration/sage-navigator/SKILL.md.
$ARGUMENTS
Related Skills
xoai/git-discipline
development
VerifiedTrustedCommunity
Branch-per-initiative git discipline for all delivery workflows. Defines branch naming by workflow, the propose-confirm creation protocol, dirty-tree and detached-HEAD handling, the always user-gated merge protocol, worktree support for parallel sessions, and abandonment cleanup. Activates only in git repositories — silently inactive everywhere else. Use when starting /build, /fix, /architect, or /build-x at Standard+ scope, when resuming an initiative, when offering a merge at a completion checkpoint, or when the user wants a second concurrent initiative.
18SKILL.mdUpdated Jun 13, 2026
xoai/build-loop
development
VerifiedTrustedCommunity
Drives task-by-task execution from an approved plan with quality gates between each task. Reads the plan, finds the next incomplete task, dispatches implementation, validates, updates progress, and continues. Use after a plan is approved and the user says "go", "start building", "execute the plan", or "implement the feature".
18SKILL.mdUpdated Apr 25, 2026
xoai/session-bridge
testing
VerifiedTrustedCommunity
Preserves and restores context across agent sessions using plan file checkboxes as source of truth. Use when starting a new session, resuming previous work, ending a session, or when the user says "continue from last time", "what was I doing", or "save progress".
18SKILL.mdUpdated Apr 25, 2026
xoai/sage-self-learning
tools
VerifiedTrustedCommunity
Captures agent mistakes, corrections, and discovered gotchas so they are not repeated. Use when: (1) a command or operation fails unexpectedly, (2) the user corrects the agent, (3) the agent discovers non-obvious behavior through debugging, (4) an API or tool behaves differently than expected, (5) a better approach is found for a recurring task. Also searches past learnings before starting tasks to avoid known pitfalls. Activate alongside the sage-memory skill — they share the same MCP backend but serve different purposes (sage-memory = codebase knowledge, sage-self-learning = agent mistakes and gotchas).
17SKILL.mdUpdated May 20, 2026