Skip to content
FunCoding

Search

Search docs, Skills and MCP

specification-system

Use when authoring rig specs, agent specs, workflow specs, startup/context fragments, operating-mode declarations, or designing the user spec library. Covers the 4 failure modes (spec instantiates topology but not workflow/mode; spec depends on local paths and fails on another host; agents modify specs as one-off files instead of preserving reusable intent; validation proves YAML shape but not whether topology can run) and the validation-vs-runtime-realization distinction.

AI 与智能体6kskills/_canonical/core/specification-system/SKILL.md

Install

Send this to Claude Code, Codex or Cursor. The agent checks the Skill for safety first and installs it only after you confirm.

读取 https://funcoding.ai/skills/mvschwarz/openrig/specification-system/install.md ,按里面的步骤帮我安装这个 Skill。

SKILL.md

Specification System

The declarative primitive family for OpenRig intent: rig specs, agent specs, workflow specs, startup/context fragments, operating-mode declarations, and the user spec library that stores and reuses them.

Specs are how humans and agents describe repeatable topology and behavior without re-explaining it in chat. They are also shareable artifacts: a user should be able to publish a spec or spec family so another user can instantiate the same rig shape, role structure, or workflow pattern.

Without a dependable spec primitive, OpenRig depends on manual startup prompts and tribal memory. That blocks repeatability, product demos, rig bundles, and autonomous rig construction.

Use this when

  • Authoring a RigSpec / AgentSpec / workflow spec
  • Designing a startup/context fragment
  • Reasoning about spec-library lifecycle (validation, sharing, upgrade semantics)
  • Auditing a spec for portability (does it run on another host?)
  • Distinguishing spec vs bundle vs extension cleanly

Don't use this when

  • The work is one-off and won't be reused. Manual rig assembly is fine for one-shot work.
  • The intent is to package a topology + workflow as a shareable artifact. That's rig-bundles-and-shareable-artifacts.
  • The intent is to add runtime behavior. That's extension-and-user-workspace.

Failure modes (4)

  1. A spec can instantiate a topology but not the workflow or operating mode needed to use it. Topology is necessary but not sufficient — workflow and operating mode must be declared too.
  2. A shared spec depends on local paths or hidden startup fragments and fails on another host. Specs must be self-describing for portability.
  3. Agents modify specs as one-off files instead of preserving reusable user/library intent. Specs are reusable; treating each instance as one-off destroys the primitive's value.
  4. Validation proves YAML shape but not whether the declared topology can actually run. Structural validation is not enough; runtime realization is the real proof.

Proof standard

Proof should:

  1. Author a spec
  2. Validate it (structural)
  3. Install it (into spec library)
  4. Instantiate it on a clean OpenRig environment
  5. Show both structural validation AND runtime realization

Validation alone is insufficient.

Spec / bundle / extension boundary

ConceptDeclaresExample
SpecTopology / role / workflow shape (declarative intent)rig.yaml, agent.yaml, workflow.yaml
BundleSpec(s) + supporting fragments packaged for shareable instantiationA Velocity Team bundle
ExtensionRuntime behavior added to user workspaceRigX command, custom view

Don't conflate them. The contract should distinguish spec, bundle, and extension cleanly.

Currently shipped surfaces

OpenRig already has:

  • RigSpec / AgentSpec authoring (agent.yaml, rig.yaml formats; see openrig-architect skill)
  • Workflow specs (markdown/YAML files, daemon read-through cache via workflow_specs table; see workflow-runtime skill)
  • Bundle/spec command surface (rig bundle / spec / agent / specs ls/show/preview/add/sync/remove/rename)
  • Spec library (filesystem-backed at packages/daemon/specs/ + ~/.openrig/specs/ per cli-reference.md)

Not yet shipped:

  • Spec library lifecycle (validation, sharing, upgrade) treated as a first-class primitive
  • Cross-host spec sharing
  • Marketplace / public registry

See also

  • openrig-architect skill — RigSpec / AgentSpec authoring discipline
  • workflow-runtime skill — workflow spec authoring + transactional-scribe contract
  • rig-bundles-and-shareable-artifacts skill — bundle is the packaged form of specs
  • extension-and-user-workspace skill — extensions add runtime behavior; specs declare intent
  • openrig/docs/reference/rig-spec.md (product reference doc) — RigSpec format specification
  • openrig/docs/reference/agent-spec.md (product reference doc) — AgentSpec format specification

Similar Skills

brand-guidelines
anthropics/skills180k

brand-guidelines

Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.

AI & agents

internal-comms
anthropics/skills180k

internal-comms

A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).

AI & agents

template-skill
anthropics/skills180k

template-skill

Replace with description of the skill and when Claude should use it.

AI & agents

mcp-builder
anthropics/skills180k

mcp-builder

Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).

AI & agents

algorithmic-art
anthropics/skills180k

algorithmic-art

Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.

AI & agents

academy-guide
anthropics/skills180k

academy-guide

Stop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content.

AI & agents