---
title: "Skillset Documentation"
slug: "skillset"
description: Routes Skillset readers to the right start, task, reference, project, or contributor documentation.
---

<a id="skillset-documentation"></a>

This is a one-time documentation snapshot for comparing [Blume](https://blume.focal.host/skillset/) and [Nimbus](https://nimbus.focal.host/skillset/). Source: [Skillset `24800e02ed4e`](https://github.com/outfitter-dev/skillset/tree/24800e02ed4e7150ea1bc7130c35603c98ea9da2/docs), copied November 2, 2026. [Snapshot manifest](/skillset-snapshot.json) · [MIT license](/skillset-LICENSE.txt).

Choose the question you are trying to answer. Each linked page states what it owns; exhaustive command and support facts come from generated reference rather than duplicated prose.

## I am new to Skillset

- [Why Skillset](/skillset/why-skillset/) explains the problem, the source-first model, and when the compiler is a good fit.
- [Install Skillset](/skillset/start/installation/) compares the native global, Homebrew, GitHub asset, Bun, CI, local dependency, and contributor routes.
- [Start with Skillset](/skillset/start/) routes from installation into a first build, adoption, daily work, and deliberate shipping workflows.
- [Build versus activation](/skillset/start/build-versus-activation/) explains what Skillset writes and what remains a separate user or provider decision.

## I need to look something up

- [Generated reference](/skillset/reference/) routes to contract-owned CLI commands, feature support, schemas, and examples.
- [Configuration](/skillset/configuration/) explains workspace settings, source frontmatter, target overrides, and tools policy.
- [Source reference](/skillset/reference/source/) documents the canonical workspace layout, rules, and preprocessing.
- [CLI reference](/skillset/reference/cli/) lists every public command and its generated route pages.
- [Feature reference](/skillset/reference/features/) defines exact authoring, output, error, example, and caveat contracts by feature or workflow.
- [Feature support matrix](/skillset/reference/support-matrix/) shows registry-owned support across canonical provider targets.
- [Glossary](/skillset/glossary/) defines the source, build, destination, provider, and activation vocabulary.

## Something failed

- [Troubleshooting](/skillset/troubleshooting/) starts from source, drift, import, recovery, watch, CI, and activation symptoms.

## I need to ship or distribute work

- [Continuous integration](/skillset/guides/continuous-integration/) adds branch-aware readiness checks and bounds automatic [generated-output](/skillset/glossary/#generated-output) repair.
- [Publishing](/skillset/guides/publishing/) separates workspace releases, downstream distribution planning, and npm package publication.
- [Marketplaces](/skillset/guides/marketplaces/) verifies curated plugin entries and writes supported provider catalog indexes deliberately.
- [Generated-state rebuild](/skillset/guides/generated-state-rebuild/) gives the owner-reviewed, recoverable path from pre-v4 locks to current projection roles.

## I am contributing

- [Contributing](https://github.com/outfitter-dev/skillset/blob/24800e02ed4e7150ea1bc7130c35603c98ea9da2/CONTRIBUTING.md) covers setup, checks, source ownership, Changesets, and review expectations.
- [Development documentation](https://github.com/outfitter-dev/skillset/blob/24800e02ed4e7150ea1bc7130c35603c98ea9da2/docs/development/README.md) routes maintainers to documentation, schema, package, feature-system, and evidence guidance.
- [Project documentation](https://github.com/outfitter-dev/skillset/blob/24800e02ed4e7150ea1bc7130c35603c98ea9da2/docs/project/README.md) routes to the design tenets and active or archived plans.
- [Documentation system](https://github.com/outfitter-dev/skillset/blob/24800e02ed4e7150ea1bc7130c35603c98ea9da2/docs/development/documentation-system.md) defines authored and generated ownership, validation, migrations, and review.
- [Security policy](https://github.com/outfitter-dev/skillset/blob/24800e02ed4e7150ea1bc7130c35603c98ea9da2/SECURITY.md) gives the private vulnerability-reporting path.

## Detailed guides

These pages cover common author and maintainer workflows:

- [Build Your First Skill](/skillset/start/quickstart/) walks through the current first-author scaffold and build.
- [Import Existing Work](/skillset/guides/importing/) separates whole-repository adoption from one explicit source import.
- [Development Loop](/skillset/guides/development-loop/) covers preview, write, watch, reconciliation, and recovery.
- [Interactive CLI](/skillset/reference/features/interactive-cli/) defines prompt eligibility and controlled-terminal behavior.
- [Package ownership](https://github.com/outfitter-dev/skillset/blob/24800e02ed4e7150ea1bc7130c35603c98ea9da2/docs/development/package-ownership.md) explains the compiler package boundaries used by maintainers.

Generated output does not grant runtime authority. Skillset renders files. It does not install, trust, activate, symlink, or mutate user-level provider configuration. See [Build Versus Activation](/skillset/start/build-versus-activation/).