# Blume

> A frozen Skillset documentation snapshot for comparing Blume and Nimbus.

## Docs

- [Blume](https://blume.focal.host/): The same Skillset documentation, rendered with Blume.

## Skillset

- [Skillset Documentation](https://blume.focal.host/skillset): Routes Skillset readers to the right start, task, reference, project, or contributor documentation.
- [Glossary](https://blume.focal.host/skillset/glossary): Defines the core terms used by Skillset's source, build, provider, and activation workflows.
- [Troubleshooting](https://blume.focal.host/skillset/troubleshooting): Diagnoses source errors, generated-output drift, adoption refusals, recovery conflicts, and runtime activation confusion.
- [Why Skillset](https://blume.focal.host/skillset/why-skillset): Explains why Skillset uses adaptive source to render honest provider-native agent loadouts.

### Configuration

- [Configuration](https://blume.focal.host/skillset/configuration): Choose the Skillset configuration layer that owns a project-level authoring decision.
- [Frontmatter](https://blume.focal.host/skillset/configuration/frontmatter): Choose and validate metadata for Skillset skills, agents, and rules.
- [Project Configuration](https://blume.focal.host/skillset/configuration/project-configuration): Configure provider selection and project-wide compiler behavior in skillset.yaml.
- [Target Overrides](https://blume.focal.host/skillset/configuration/target-overrides): Configure provider-specific output and behavior without duplicating shared source intent.
- [Tools Policy](https://blume.focal.host/skillset/configuration/tools-policy): Express portable and provider-specific tool intent without overstating enforcement.

### Guides

- [Build and Verify a Plugin Marketplace](https://blume.focal.host/skillset/guides/marketplaces): Declares a curated plugin catalog, verifies entry readiness, and renders provider-native marketplace indexes without activating them.
- [Import Existing Work](https://blume.focal.host/skillset/guides/importing): Adopts supported provider-native material into canonical Skillset source without overwriting existing source or changing runtime configuration.
- [Prepare Skillset Work for Publication](https://blume.focal.host/skillset/guides/publishing): Separates workspace releases, downstream distribution planning, marketplace catalogs, and npm package publication.
- [Rebuild Generated State for Inherent Standards](https://blume.focal.host/skillset/guides/generated-state-rebuild): Rebuilds pre-v4 generated state for current projection roles without granting old locks cleanup authority.
- [Use the Development Loop](https://blume.focal.host/skillset/guides/development-loop): Edits canonical Skillset source, previews and verifies generated output, and routes target-side changes through explicit recovery workflows.
- [Verify Skillset in Continuous Integration](https://blume.focal.host/skillset/guides/continuous-integration): Adds Skillset readiness checks to CI and limits automatic repair to safe source-driven generated-output drift.

### Reference

- [Reference](https://blume.focal.host/skillset/reference): Routes readers to Skillset's generated CLI, support, schema, and example reference.
- [CLI Flag Conventions](https://blume.focal.host/skillset/reference/cli-flags): Explains Skillset's shared CLI flag rules and projects the complete contract-owned flag and environment vocabulary.
- [Feature Support Matrix](https://blume.focal.host/skillset/reference/support-matrix): Shows registry-owned Skillset feature status across every canonical provider target.
- [Hosted Provider Validation](https://blume.focal.host/skillset/reference/provider-validation): Records exact hosted provider-validation pins, covered surfaces, and explicit fallback boundaries.
- [Standard Profiles](https://blume.focal.host/skillset/reference/standard-profiles): Records adopted Agent Instructions, Agent Skills, and Agent Plugins portability profiles and their immutable conformance evidence.

#### CLI

- [CLI Reference](https://blume.focal.host/skillset/reference/cli): Lists Skillset's public CLI commands, shared exit classes, and links to contract-generated command reference.
- [skillset build](https://blume.focal.host/skillset/reference/cli/build): The Skillset build command can preview or write generated provider outputs.
- [skillset change](https://blume.focal.host/skillset/reference/cli/change): The Skillset change command can record and inspect source changes before release.
- [skillset check](https://blume.focal.host/skillset/reference/cli/check): The Skillset check command can validate source, generated outputs, and CI readiness.
- [skillset create](https://blume.focal.host/skillset/reference/cli/create): The Skillset create command can create a named Skillset repository.
- [skillset dev](https://blume.focal.host/skillset/reference/cli/dev): The Skillset dev command can watch source and continuously preview or write changes.
- [skillset diff](https://blume.focal.host/skillset/reference/cli/diff): The Skillset diff command can show the generated-output plan without writing it.
- [skillset distribute](https://blume.focal.host/skillset/reference/cli/distribute): The Skillset distribute command can plan distribution-ready plugin artifacts.
- [skillset draft](https://blume.focal.host/skillset/reference/cli/draft): The Skillset draft command can preview and atomically fork a shipped skill into its draft sibling.
- [skillset eval](https://blume.focal.host/skillset/reference/cli/eval): The Skillset eval command can list, run, and inspect portable skill evals.
- [skillset explain](https://blume.focal.host/skillset/reference/cli/explain): The Skillset explain command can explain ownership and provenance for a path.
- [skillset hooks](https://blume.focal.host/skillset/reference/cli/hooks): The Skillset hooks command can print and run explicit hook integrations.
- [skillset import](https://blume.focal.host/skillset/reference/cli/import): The Skillset import command can import provider-native or Agent standards skills and plugins into source.
- [skillset init](https://blume.focal.host/skillset/reference/cli/init): The Skillset init command can initialize Skillset in an existing directory.
- [skillset list](https://blume.focal.host/skillset/reference/cli/list): The Skillset list command can list authored units and their generated outputs.
- [skillset lookup](https://blume.focal.host/skillset/reference/cli/lookup): The Skillset lookup command can look up schema, compatibility, and provider facts.
- [skillset marketplace](https://blume.focal.host/skillset/reference/cli/marketplace): The Skillset marketplace command can check and update curated plugin marketplaces.
- [skillset move](https://blume.focal.host/skillset/reference/cli/move): The Skillset move command can preview and atomically move a skill between workspace and plugin collections.
- [skillset new](https://blume.focal.host/skillset/reference/cli/new): The Skillset new command can create a new plugin, skill, project agent, rule, or hook in source.
- [skillset promote](https://blume.focal.host/skillset/reference/cli/promote): The Skillset promote command can preview and atomically promote a draft skill to its shipped sibling.
- [skillset reconcile](https://blume.focal.host/skillset/reference/cli/reconcile): The Skillset reconcile command can reconcile a managed source/output conflict.
- [skillset release](https://blume.focal.host/skillset/reference/cli/release): The Skillset release command can audit, plan, apply, and amend releases.
- [skillset rename](https://blume.focal.host/skillset/reference/cli/rename): The Skillset rename command can preview and atomically rename an authored source path.
- [skillset report](https://blume.focal.host/skillset/reference/cli/report): The Skillset report command can inspect immutable operational reports.
- [skillset resolve](https://blume.focal.host/skillset/reference/cli/resolve): The Skillset resolve command can repair and stage generated-output conflicts during a rebase or merge.
- [skillset restore](https://blume.focal.host/skillset/reference/cli/restore): The Skillset restore command can restore a recorded generated-output backup.
- [skillset status](https://blume.focal.host/skillset/reference/cli/status): The Skillset status command can summarize workspace health and generated drift.
- [skillset test](https://blume.focal.host/skillset/reference/cli/test): The Skillset test command can run declared or ad hoc provider runtime tests.
- [skillset update](https://blume.focal.host/skillset/reference/cli/update): The Skillset update command can update provider-format snapshots and generated outputs.

#### Features

- [Feature Reference](https://blume.focal.host/skillset/reference/features): The feature reference routes authors to exact Skillset contracts, workflow references, support vocabulary, and maintainer evidence.
- [Agents](https://blume.focal.host/skillset/reference/features/agents): Agents define project roles, skill references, provider output, compatibility limits, and validation.
- [Apps](https://blume.focal.host/skillset/reference/features/apps): ChatGPT product-bundle apps define manifest discovery, typed component output, conflicts, and current configuration limits.
- [Build Scopes](https://blume.focal.host/skillset/reference/features/build-scopes): Build scopes select generated destinations for preview, writing, inspection, and isolated builds.
- [Changes](https://blume.focal.host/skillset/reference/features/changes): Skillset change records capture source-change reasons, verify coverage, and preserve evidence for releases.
- [CI](https://blume.focal.host/skillset/reference/features/ci): Skillset CI provides branch-aware readiness checks, bounded output repair, reports, and a workflow scaffold.
- [Commands](https://blume.focal.host/skillset/reference/features/commands): Plugin commands define Claude and Cursor source paths, pass-through output, and unsupported targets.
- [Dependencies](https://blume.focal.host/skillset/reference/features/dependencies): Dependencies define internal and external plugin requirements, provider rendering, validation, and provenance.
- [Dev Watch](https://blume.focal.host/skillset/reference/features/dev-watch): Skillset development mode watches source, previews drift, and optionally writes generated output.
- [Distributions](https://blume.focal.host/skillset/reference/features/distributions): Skillset distributions plan downstream delivery of built artifacts without syncing, publishing, or activating them.
- [Executables](https://blume.focal.host/skillset/reference/features/executables): Plugin executables define discovery, source pointers, file modes, provider support, and validation errors.
- [Feature Source Pointers](https://blume.focal.host/skillset/reference/features/feature-source-pointers): Feature source pointers define conventional discovery and explicit repository paths for MCP and executable plugin features.
- [Hooks](https://blume.focal.host/skillset/reference/features/hooks): Skillset hooks define native and adaptive source, events, actions, attachments, provider rendering, and activation limits.
- [Interactive CLI](https://blume.focal.host/skillset/reference/features/interactive-cli): Skillset's interactive CLI defines when prompts appear, how they inherit command safety, and how automation avoids them.
- [LSP Servers](https://blume.focal.host/skillset/reference/features/lsp-servers): Claude plugin LSP servers define configuration discovery, manifest wiring, JSON validation, and provider limits.
- [Marketplaces](https://blume.focal.host/skillset/reference/features/marketplaces): Skillset marketplaces declare provider catalogs, verify plugin readiness, and write supported marketplace indexes.
- [MCP Servers](https://blume.focal.host/skillset/reference/features/mcp-servers): Plugin MCP servers define discovery, source pointers, validation, provider paths, and lock provenance.
- [Monitors](https://blume.focal.host/skillset/reference/features/monitors): Claude plugin monitors define experimental source paths, manifest wiring, validation, and provider limits.
- [Operational Reports](https://blume.focal.host/skillset/reference/features/operational-reports): Operational reports are immutable, globally retained Skillset receipts that can be retrieved by UUID or owned store path.
- [Output Safety](https://blume.focal.host/skillset/reference/features/output-safety): Skillset output safety distinguishes managed output, protects neighboring files, and restores reversible backups.
- [Output Styles](https://blume.focal.host/skillset/reference/features/output-styles): Claude plugin output styles define discovery, manifest wiring, pass-through behavior, and provider limits.
- [Plugins](https://blume.focal.host/skillset/reference/features/plugins): Plugins define source containers, manifest authority, component ownership, and provider bundle boundaries.
- [Provider Source](https://blume.focal.host/skillset/reference/features/target-native-islands): Provider source defines native input paths, pass-through validation, output ownership, and cross-target isolation.
- [Reconcile Generated Edits](https://blume.focal.host/skillset/reference/features/reconcile): Skillset reconciliation safely resolves managed generated edits against their canonical source projection.
- [Releases and Changelogs](https://blume.focal.host/skillset/reference/features/releases): Skillset releases plan and apply workspace versions, changelogs, release evidence, and generated updates.
- [Resources](https://blume.focal.host/skillset/reference/features/resources): Resources define marked-link copies, explicit shared file selection, destination mapping, executable modes, path safety, and drift.
- [Rules](https://blume.focal.host/skillset/reference/features/rules): Rules define adaptive guidance metadata, path scoping, provider projections, and command-policy boundaries.
- [Runtime Activation Readiness](https://blume.focal.host/skillset/reference/features/runtime-activation-readiness): Runtime activation readiness defines observational stages, evidence effects, claim ceilings, reports, and manual next actions.
- [Settings](https://blume.focal.host/skillset/reference/features/settings): Skillset composes one project-local SessionStart entry while leaving user-level provider settings untouched.
- [Skills](https://blume.focal.host/skillset/reference/features/skills): Skills define portable source, identity, provider output, validation, and generated provenance.
- [Supports](https://blume.focal.host/skillset/reference/features/supports): Support constraints define compatibility ranges, mismatch policy, inheritance, and source-unit provenance.
- [Tests and Evals](https://blume.focal.host/skillset/reference/features/tests-and-evals): Skillset tests and evals define deterministic checks, activation probes, runtime trials, reports, and retention.
- [Themes](https://blume.focal.host/skillset/reference/features/themes): Claude plugin themes define experimental discovery, manifest wiring, pass-through behavior, and provider limits.
- [Tools Policy](https://blume.focal.host/skillset/reference/features/tools-policy): Tools policy defines portable intent, provider overlays, realization tiers, conflicts, and residual risk.
- [Version Audit](https://blume.focal.host/skillset/reference/features/version-audit): Skillset version audit compares current version authority with supported generated Claude and Codex artifacts.

#### Providers

- [Provider Reference](https://blume.focal.host/skillset/reference/providers): Explains Skillset's provider vocabulary and routes to canonical targets and generated support facts.
- [Claude Provider](https://blume.focal.host/skillset/reference/providers/claude): Explains how Skillset renders adaptive and Claude-native source into Claude provider output.
- [Codex Provider](https://blume.focal.host/skillset/reference/providers/codex): Explains how Skillset renders adaptive and Codex-native source into Codex provider output.
- [Cursor Provider](https://blume.focal.host/skillset/reference/providers/cursor): Explains how Skillset renders adaptive and Cursor-native source into Cursor provider output.

#### Schemas

- [Skillset Schemas](https://blume.focal.host/skillset/reference/schemas)

#### Source

- [Source Reference](https://blume.focal.host/skillset/reference/source): Routes authors to the canonical workspace layout, rule source model, and Markdown preprocessing reference.
- [Preprocessing](https://blume.focal.host/skillset/reference/source/preprocessing): Defines Skillset Markdown preprocessing variables, prompt arguments, exact partials, marked links, escapes, and failure behavior.
- [Rules](https://blume.focal.host/skillset/reference/source/rules): Defines portable rule source, path scoping, provider destination behavior, ownership, and target-native command-policy boundaries.
- [Workspace Layout](https://blume.focal.host/skillset/reference/source/workspace-layout): Defines the canonical Skillset workspace tree, authored source families, generated-output boundary, and operational storage paths.

### Start

- [Start with Skillset](https://blume.focal.host/skillset/start): Guides authors from a first Skillset build through adoption, daily work, and deliberate shipping workflows.
- [Build Versus Activation](https://blume.focal.host/skillset/start/build-versus-activation): Separates Skillset's deterministic repository builds from provider installation, trust, and runtime activation.
- [Build Your First Skill](https://blume.focal.host/skillset/start/quickstart): Builds one standalone skill from canonical source and verifies its repo-local provider-native output.
- [How Rendering Works](https://blume.focal.host/skillset/start/how-rendering-works): Traces canonical Skillset source through validation and target rendering into deterministic provider-native destinations.
- [Install Skillset](https://blume.focal.host/skillset/start/installation): Installs Skillset through the native global, Homebrew, GitHub asset, Bun, CI, local dependency, or contributor route with exact runtime requirements.
- [Walk Through the First-Author Example](https://blume.focal.host/skillset/start/first-author): Walks through the executable first-author fixture from clean check to source edit and deterministic regeneration.

## Agent skills

- [blume](https://blume.focal.host/.well-known/agent-skills/blume/SKILL.md): Read the Blume docs instead of answering from memory. A frozen Skillset documentation snapshot for comparing Blume and Nimbus. Use when a task involves Blume: how it works, how to set it up or configure it, or its API.

## Agent resources

- [llms-full.txt](https://blume.focal.host/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://blume.focal.host/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](https://blume.focal.host/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://blume.focal.host/openapi.json.
- [Agent skills](https://blume.focal.host/.well-known/agent-skills/index.json): Agent Skills discovery index of the skills this site publishes.
- [API catalog](https://blume.focal.host/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [AI catalog](https://blume.focal.host/.well-known/ai-catalog.json): ARD manifest of the agent-facing resources on this site (MCP server, skills, APIs).
- [agent-readability.json](https://blume.focal.host/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://blume.focal.host/sitemap.xml): Every indexable page URL with its last-modified date.