install-docs-skills
Identify which Crux plugin version is active in this session; provide read-only Crux installation, upgrade, and schema guidance when requested.
- License 许可
- MIT
- 最近更新
- 2026-11-12
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- install-docs-skills
- metadata
- { "tags": "installation, plugin, distribution", "bundles": "crux-docs", "triggers": "which crux version is active | what crux plugin is loaded | install docs skills | add this plugin | set up crux | upgrade docs suite", "risk_level": "low", "routing_note": "Read-only active identity; install and upgrade instructions load on request.", "requires_access": "read-local" }
- description
- Identify which Crux plugin version is active in this session; provide read-only Crux installation, upgrade, and schema guidance when requested.
02 资源文件 1
- 参考文档references/install-and-upgrade.md26.1 KB
03 SKILL.md 正文
Install Docs Skills
<!-- BEGIN GENERATED: runtime-compat -->
Runtime compatibility
This skill is portable across Claude Code, Codex, OpenCode, and OMP (Oh My Pi). This section overrides platform-specific labels below.
- Before running a command that uses
CRUX_PLUGIN_ROOT, set it to the installed plugin root. In Claude Code, use the value ofCLAUDE_PLUGIN_ROOT. In Codex, OpenCode, and OMP, derive it from the absolute path of this selectedSKILL.md: the plugin root is the parent of itsskills/directory (in OMPbash,skill://<name>resolves to the skill directory). In a source checkout, use the checkoutcrux/directory. - For project-local skills, use
.claude/skillsin Claude Code,.agents/skillsin Codex,.opencode/skillsin OpenCode (which also reads the singular.opencode/skill), and.omp/skillsin OMP. SetCRUX_LOCAL_SKILLS_DIRto that path before following any command below that uses it. - Translate Claude Code tool labels such as
Agent,Read,Write,Bash,WebSearch, andWebFetchto the matching capability in the current session. Codex names its own capabilities; OpenCode uses the lowercase formssubagent,read,edit,shell,websearch, andwebfetch, whereeditcovers bothEditandWrite; OMP usestask,read,edit,write,bash,grep,glob,find,todo, andweb_search(wherereadalso handles URLs andskill://URIs). Do not attempt to invoke the Claude Code labels as literal commands on another host. - Install the generated role agents before delegating:
install-codex-agentsin Codex,install-opencode-agentsin OpenCode,install-omp-agentsin OMP. Codex names themcrux_architect,crux_brainstormer,crux_commander,crux_dev_lead,crux_developer,crux_historian,crux_librarian,crux_night_gardener,crux_reviewer, andcrux_wayfinder; OpenCode and OMP use the bare role namesarchitect,brainstormer,commander,dev-lead,developer,historian,librarian,night-gardener,reviewer, andwayfinder(in OMP,scoutmay also be used for reconnaissance alongsidewayfinder). If a required role or capability is unavailable, report that truthfully instead of claiming it ran. - Argument placeholders such as
$adrand$bookbind only in Claude Code. On a host without argument binding they are unset — take the value from the user's phrase. The "Fields OpenCode ignores" section ofOPENCODE_GUIDE.mdnames the invocation-control fields OpenCode ignores. <!-- END GENERATED: runtime-compat -->
Choose the request
For “which Crux version is active?”, “what Crux plugin is loaded?”, or an explicit invocation with no install request, follow Active identity below. Do not read the installation reference for an identity-only request. A question about a Node, Python, or other non-Crux version does not invoke this skill.
For an explicit or natural Crux install, upgrade, or tree-schema guidance request, read references/install-and-upgrade.md, resolved relative to this selected SKILL.md. It retains the host-specific commands, compatibility checks, recovery guidance, hand-off, and logging rules. If the reference is missing or unreadable, report that fact and do not improvise install or migration steps from memory or a different cached copy. For “set up Crux”, report identity first and clarify whether the user means plugin installation or project-tree initialization.
This skill does not install the plugin or initialize a tree. Marketplace commands are instructions for the user to run in the host UI. Do not install, upgrade, edit marketplace settings, or invoke init-docs merely because this skill loaded.
Active identity (read-only)
- Obtain the absolute path of the selected loaded Crux
SKILL.mdfrom the host invocation, or a host load trace that identifies the selected copy. Derive the plugin root as the parent of that file'sskills/directory. Claude Code may provideCLAUDE_PLUGIN_ROOTinside the loaded skill; an empty variable in an unrelated shell does not prove anything. Do not infer selection from this repository, a marketplace registry, or a cache listing. - At that evidenced root, read
plugin.json. Confirmnameiscruxand readversion;schema_versionthere is the skill-frontmatter contract, not the target documentation-tree schema. If the manifest is missing, malformed, names another plugin, or lacks a valid version, report the fault and leave active identity unverified. Do not substitute a cached manifest. - Report the active version with the selected path or load-trace evidence. If no selected root or trace is available, say “Active Crux version unverified in this session.” Do not guess. If the user also asks about installed copies, a valid marketplace cache manifest may identify a cached candidate; label it candidate-only, even if it has a newer version or a disabled registration. It never proves what this session loaded.
The identity path reads only evidence. It does not execute an installer, recommend an upgrade from cache alone, compare a candidate's tree compatibility as if it were active, or bootstrap documentation. The detailed reference is loaded only for an install, upgrade, or schema request.
04 同仓库更多 Skills
whiteboarding
Explore an idea through docs-informed dialogue before committing to a design. Capture the exploration for later filing as a brief.
verify-code-docs
Check generated code documentation against source and report drift without regenerating it.
transition-observation
Apply a human disposition to an observation's lifecycle state without changing its claim or body.
transition-invariant
Ratify, reject, or retire an invariant on human direction. Update lifecycle metadata without changing the invariant's body.
transition-decision
Apply a human ratify, reject, or defer verdict to a recovered decision candidate; ratification creates a Proposed ADR or observation.
transition-brief
Publish or abandon a draft brief, updating lifecycle metadata and indexes without changing its body.