document-spf-feature

Creates and updates evidence-grounded feature registry entries for the SPF media engine.

931|91|Updated Aug 13, 2025
One-click install
npx skills add https://github.com/videojs/v10 --skill document-spf-feature
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: document-spf-feature
Source: https://github.com/videojs/v10/tree/main/.agents/skills/document-spf-feature
Command: npx skills add https://github.com/videojs/v10 --skill document-spf-feature

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Drafting feature documentation directly from a single source often produces entries that misread scope, claim unimplemented behavior, or drift out of sync with related docs. This Skill enforces a disciplined workflow that triangulates sources, grounds claims in code, and keeps the SPF feature registry internally consistent.

Core Features & Use Cases

  • Source triangulation and decomposition check: Gathers context from Notion docs, GitHub issues, pasted writeups, and existing feature docs, then recommends whether to extend an existing entry or create a standalone one.
  • Code-grounded drafting: Maps behaviors, actors, state slots, and config inputs from the codebase so implementation claims match reality, with definition depths (coarse, technical, sketched) matched to feature maturity.
  • Failure-mode catalog and cross-doc cascade: Applies a growing catalog of known risk patterns (MSE codec-change checks, multi-writer slots, API-as-feature inflation) and cascades narrow updates to related feature docs.
  • Use Case: When asked to document the current depth of discontinuity handling, the Skill produces a compact entry separating implemented behavior, remaining decisions, constraints, and source pointers, then updates related registry docs.

Quick Start

Ask the assistant to document a new SPF feature or update an existing feature registry entry, providing the feature name or a description.

Frequently Asked Questions about document-spf-feature

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

FAQPage Schema
How do I document a new SPF feature?

Invoke the skill with a feature name or description, optionally linking Notion docs or GitHub issues. The workflow triangulates sources, confirms scope and definition depth with you, grounds claims in the codebase, then drafts the registry entry for your review before writing.

How do I update an existing SPF feature doc?

Invoke the skill on the existing feature name; it reads the current doc and makes targeted edits rather than wholesale rewrites. Resolved open questions move into their constraining sections, and related docs receive narrow cascade updates.

When should a feature get its own doc versus extending an existing one?

A standalone doc is earned only when the concern has substantial independent implementation footprint, independent priority or timeline, or implies a primitive other features consume. Otherwise the default is extending the closest existing doc's phase rows or scope sections.

What definition depths does the feature registry support?

Three depths: coarse for proposed features under discussion, technical for articulated scope without implementation, and sketched for implemented code-grounded features. The depth determines which template sections the doc includes.

Does the skill implement the feature it documents?

No. The skill only produces documentation and never implements the feature unless explicitly requested. It also refuses to mark work as implemented without code and verification evidence.