Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/modiqo/skillspec/llms.txt

Use this file to discover all available pages before exploring further.

SkillSpec has two parts to install. The CLI binary (skillspec) handles everything you run from a terminal — Doctor reports, validation, porting, tracing, and local skill installs. The harness plugin wires those same commands into Claude Code or Codex so your agent can drive them from a chat prompt. You need the CLI regardless; the plugin is required only if you want in-harness invocation.

​
CLI Install

The release installer is the fastest path on macOS and Linux. It detects your platform, downloads the right binary from the latest GitHub release, verifies the SHA256 checksum, and installs to ~/.local/bin by default.
curl -fsSL https://skillspec.sh/install.sh | sh
To pin a specific version or choose a different install directory, pass environment variables inline:
curl -fsSL https://skillspec.sh/install.sh \
  | SKILLSPEC_VERSION=v0.1.0 SKILLSPEC_INSTALL_DIR="$HOME/.local/bin" sh
Environment variableDefaultPurpose
SKILLSPEC_VERSIONlatestRelease tag to install, e.g. v0.1.0.
SKILLSPEC_INSTALL_DIR~/.local/binDirectory the skillspec binary is written to.
SKILLSPEC_REPOmodiqo/skillspecGitHub owner/repo to download release assets from.
If ~/.local/bin is not on your PATH, the installer will print a reminder. Add export PATH="$HOME/.local/bin:$PATH" to your shell profile to make skillspec available everywhere.

​
Platform Notes

Prebuilt binaries are published for three platforms with every release:
PlatformAsset
macOS (Apple Silicon and Intel)skillspec-macos.tar.gz
Linux x86_64skillspec-linux-x86_64.tar.gz
Windows x86_64skillspec-windows-x86_64.zip
Every release artifact ships with a matching .sha256 checksum file. The release installer verifies the checksum automatically before extracting. For manual downloads, verify with: 
# Linux / macOS
sha256sum -c skillspec-linux-x86_64.tar.gz.sha256

# macOS alternative
shasum -a 256 -c skillspec-macos.tar.gz.sha256
On platforms not covered by the prebuilt binaries — such as Linux ARM — the installer will exit with an error and suggest cargo install skillspec as the fallback.

​
Harness Plugin Install

The plugin adds SkillSpec commands to your agent harness. Once installed, you can ask your agent things like /skillspec run doctor on ./my-skill or /skillspec import ./my-skill, compile it, test it, and print the alignment summary.
Add the SkillSpec plugin from the marketplace, then install it into your active Claude Code session:
claude plugin marketplace add modiqo/skillspec --sparse .claude-plugin plugins/skillspec
claude plugin install skillspec@skillspec
claude plugin list
--sparse .claude-plugin plugins/skillspec fetches only the plugin directory from the repository instead of cloning the full tree.

​
Local Dev Skill Install

For local development, you can install the SkillSpec skill folder directly into a harness without going through the plugin marketplace. The --retire-existing flag removes any previously installed version of the same skill before writing the new one. 
# Install into Codex
skillspec install skill skills/skillspec --target codex --retire-existing

# Install into the generic agents harness
skillspec install skill skills/skillspec --target agents --retire-existing

# Install into Claude local project
skillspec install skill skills/skillspec --target claude-local --retire-existing

​
Verify the Install

skillspec --version
If the binary is on your PATH and the install succeeded, this prints the version string. If the command is not found, confirm that the install directory is in $PATH.
Local development with the Justfile. The repository includes a Justfile that keeps the full local development workflow — build, install, harness skill wiring — in one place. Key recipes:
# Debug build + CLI install + all detected harness skill installs in one shot
just dev-install-all

# Local preflight before pushing: formatting, locked CI checks, examples, conformance
just preflight

# See which harness roots SkillSpec can install into
just install-targets
just preflight runs formatting, locked workspace checks, Clippy, tests, package file-list checks for every split crate, example validation, and conformance fixture checks — the same set of checks that run in CI.

Build docs developers (and LLMs) love

Get started for freeTalk to us