formspec-companion-authoring

Name: formspec-companion-authoring
Availability: InStock
Author: Formspec-org

Author Formspec companion specifications that preserve core semantics.

4|2|Updated Mar 26, 2026

Search Tags:#documentation #extension #spec-authoring #conformance #formspec #schema-guidance

Ready to run

npx skills add https://github.com/Formspec-org/formspec --skill formspec-companion-authoring

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: formspec-companion-authoring
Source: https://github.com/Formspec-org/formspec/tree/main/.claude-plugin/skills/formspec-companion-authoring
Command: npx skills add https://github.com/Formspec-org/formspec --skill formspec-companion-authoring

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams author Formspec companion specifications and review external specs to ensure additive compatibility with the Core Formspec specification, preventing changes to core semantics while expanding capabilities.

Core Features & Use Cases

Provide a structured framework to apply conventions from the Core and schema guides when drafting companion docs.
Ensure alignment with reference documents such as the Formspec Schema Authoring Guide and the Specification Style Guide.
Support workflows for authoring companion specs, add-ons, references, and ontology materials that attach to a Definition without altering data capture or processing models.

Quick Start

Draft a companion spec that adds capability without redefining core Formspec semantics, citing the relevant reference guides.

Frequently Asked Questions about formspec-companion-authoring

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I write a companion specification that extends a Formspec Definition without changing core semantics?▼

To author a Formspec companion spec, you draft an add-on document that attaches to a Formspec Definition while preserving core data capture and processing models. This ensures additive compatibility with the Core specification without altering existing semantics.

What is a Formspec companion spec and when do I need one?▼

A Formspec companion spec is a document that adds capabilities, such as add-ons or ontology materials, to a Definition without altering core processing. You need one when expanding Formspec features while ensuring conformance with the Core specification.

What reference guides do I need to follow for Formspec schema authoring?▼

Formspec schema authoring requires adherence to the schema-authoring-guide.md and spec-style-guide.md reference documents. These guides provide the conventions and structured framework needed to ensure your companion specs align with Core Formspec standards.

How do I structure SKILL.md for a Formspec companion spec?▼

Structuring SKILL.md for a Formspec companion spec requires including YAML frontmatter with name and description fields. This frontmatter enforces adherence to reference guidance and ensures the companion spec is properly formatted for Formspec processing.

Can I add ontology materials to a Formspec Definition without breaking conformance?▼

You can add ontology materials and references to a Formspec Definition without breaking conformance by ensuring they are purely additive. The companion spec must preserve core semantics and processing models, expanding capabilities without redefining existing data capture rules.

What are the limitations when authoring add-ons for a Formspec companion specification?▼

When authoring Formspec add-ons, you cannot redefine core Formspec semantics or alter data capture and processing models. Companion specs must remain strictly additive, meaning any changes that modify the Core specification's behavior will break conformance.