nx/skills/using-nx-skills/SKILL.md
Use when starting any conversation or task — establishes that nx skills must be checked before every response, including clarifying questions. If a skill plausibly applies, invoke it.
npx skillsauth add hellblazer/nexus using-nx-skillsInstall 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.
If a skill plausibly applies, invoke it. False positives are cheap; misses cost time. Skills evolve — read the current version, don't rely on memory.
Before any multi-agent pipeline:
mcp__plugin_nx_nexus__plan_search(query="<task description>", limit=3)After a successful pipeline:
mcp__plugin_nx_nexus__plan_save(query="<task>", plan_json={"steps":[...],"tools_used":[...],"outcome_notes":"..."}, tags="<agents>")Before code:
/nx:brainstorming-gate (mandatory)/nx:create-plan/nx:architecture then /nx:create-planSomething broken:
/nx:debug immediately/nx:debug → invoke nowAnalyzing code:
/nx:analyze-code/nx:deep-analysisExecuting:
/nx:implement/nx:enrich-planQuality gates:
/nx:review-code/nx:plan-audit (validates against codebase)/nx:substantive-critique/nx:test-validateAnalytical questions (route through nx_answer):
/nx:query/nx:research/nx:review/nx:analyze/nx:debug/nx:document/nx:knowledge-tidy/nx:pdf-processDirect search / query MCP calls are for keyword retrieval ("find X in collection Y"). Verb-shaped questions go through nx_answer.
RDR lifecycle: /nx:rdr-create → /nx:rdr-research → /nx:rdr-gate → /nx:rdr-accept → /nx:rdr-close. List/show: /nx:rdr-list, /nx:rdr-show NNN. Audit: /nx:rdr-audit.
Git: isolation → /nx:git-worktrees. Done → /nx:finishing-branch. Receiving review → /nx:receiving-review.
Catalog/linking: entries, links, tumblers, link-context seeding → /nx:catalog.
Reference (no agent dispatch): /nx:serena-code-nav, /nx:nexus, /nx:cli-controller, /nx:writing-nx-skills.
Sequential Thinking (mcp__plugin_nx_sequential-thinking__sequentialthinking): debugging hypotheses, design choices, plan evaluation. needsMoreThoughts: true to continue, isRevision: true to correct.
nx Storage Tiers (read widest → narrowest before any work):
nx search: permanent knowledge across all sessions/projectsnx memory: project decisions, findings, session contextnx scratch: this session's discoveries, shared across all agentsWrite path: T1 (immediate, shared) → --persist to T2 (survives session) → /nx:knowledge-tidy to T3 (permanent, cross-project).
| Mistake | Correction |
|---------|------------|
| search for an analytical question | nx_answer via /nx:query or a verb skill |
| Test fails → try a different fix | /nx:debug |
| Implement without brainstorming-gate | brainstorming-gate first |
| Plan exists, start implementing | /nx:plan-audit first |
| Symbol callers via grep | /nx:serena-code-nav |
| Implement review feedback blindly | /nx:receiving-review first |
| Manual worktree setup | isolation: "worktree" on Agent tool, or /nx:git-worktrees |
development
Use when critiquing / auditing / reviewing a change set against decision history — tries the review plan library first (catalog lookup → decision-evolution traversal → extract → compare), falls through to /nx:query if nothing matches
documentation
Use when doing design / architecture / planning work that walks from prose (RDRs, docs, knowledge) into the modules implementing a concept
development
Use when surveying the plan library's runtime metrics to propose plans for promotion to a higher scope — advisory-only; dispatches the plan-promote-propose meta-seed (no lifecycle ops — those ship in RDR-079)
business
Use when inspecting plan runtime metrics or enumerating dimension-registry usage — dispatches plan_match with dimensions={verb:plan-inspect}; strategy:default reports per-plan metrics, strategy:dimensions reports registry usage counts