runtime/plugin-overlay/skills/sage/SKILL.md
Start here. Sage reads project state, routes via keywords, classifies intent, and guides you to the right workflow.
npx skillsauth add xoai/sage sageInstall 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.
RULES (apply to every step — non-negotiable):
Sage's intelligent entry point. Assess the project and guide the user.
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.
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
Based on user's choice or free-form input, classify scope and route:
For complex routing or gap detection, read the sage-navigator at
sage/core/capabilities/orchestration/sage-navigator/SKILL.md.
$ARGUMENTS
testing
Root cause diagnosis with evidence, Reproducing test, Minimal patch
tools
Session resumption with context
tools
Configure Sage preset and project settings. Switch between base, startup, enterprise, or opensource constitution presets. Use when the user says "configure sage", "change preset", or "sage settings".
development
Brief (medium+ tasks), Spec, Implementation plan