formspec-companion-authoring

Author Formspec companion specifications aligned with core and style guidelines.

Updated Feb 25, 2026
One-click install
npx skills add https://github.com/mikewolfd/formspec --skill formspec-companion-authoring-mikewolfd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: formspec-companion-authoring
Source: https://github.com/mikewolfd/formspec/tree/main/.claude-plugin/skills/formspec-companion-authoring
Command: npx skills add https://github.com/mikewolfd/formspec --skill formspec-companion-authoring-mikewolfd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Formspec companion authoring skill solves the challenge of consistently creating and reviewing companion or add-on specifications for the Formspec ecosystem, ensuring adherence to core conventions, style guides, and frontmatter requirements.

Core Features & Use Cases

  • Guiding the authoring workflow for companion specs: declaring relationships to Core, additive invariant, and cross-reference standards.
  • Providing structured frontmatter and normative prose templates (style, schema references, and conformance sections) to accelerate documentation.
  • Enabling review of external specs for Formspec compatibility, alignment checks, and governance-ready outputs.

Quick Start

Draft a Formspec companion specification that follows Core conventions and references the provided style guides.

Frequently Asked Questions about formspec-companion-authoring

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

FAQPage Schema
What is a Formspec companion spec and when do I need to author one?

A Formspec companion spec is an add-on specification extending the Formspec core ecosystem. You need to author one when drafting additive invariants, schema guides, or cross-references requiring strict alignment with core conventions and style guidelines.

How do I ensure frontmatter conformance when authoring specification documentation?

To ensure frontmatter conformance in specification documentation, enforce presence of identity fields, structured description sections, metadata dependencies, components, and keywords. This enables tooling validation and strict schema conformance across your docs.

How do I check if an external specification aligns with Formspec core conventions?

To check external specification alignment with Formspec, review the document against core style guides, verify frontmatter requirements, and validate additive invariants and schema references for governance-ready outputs.

What sections are required in a Formspec companion specification description?

Required sections in a Formspec companion specification description include relationships to Core, additive invariant declarations, cross-reference standards, schema references, and conformance sections to pass toxicity checks and tooling validation.

Do I need dependencies or components defined to draft a Formspec companion spec?

Defining dependencies and components in frontmatter is required to draft a Formspec companion spec. These metadata fields enable tooling validation, ensure schema conformance, and maintain strict alignment with the Formspec core ecosystem.

Why does my companion spec fail Formspec schema conformance checks?

Companion specs fail Formspec schema conformance checks due to missing frontmatter identity fields, absent mandated description sections, incomplete metadata like dependencies and keywords, or unresolved additive invariants and cross-reference standards.