faffidavit-rendering

Defines and validates house output style for terminal and tracker rendering.

3|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/shftwst/faff --skill faffidavit-rendering-shftwst
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: faffidavit-rendering
Source: https://github.com/shftwst/faff/tree/main/plugin/skills/faffidavit-rendering
Command: npx skills add https://github.com/shftwst/faff --skill faffidavit-rendering-shftwst

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI-generated output often arrives as unreadable walls of prose, broken markdown tables, or jargon-heavy status reports that force readers to decode internal references. This Skill standardizes how all human-facing output is rendered and validates drafts against those rules. ## Core Features & Use Cases - House style definition: Establishes the visual-vs-prose split, a closed catalogue of canonical visual forms (cycle brackets, queue partition grids, workstream lanes, gate tables), density caps, and prose skimmability rules. - Validation and normalisation: Reviews draft output and flags or rewrites violations such as markdown tables that should be definition lists, ungrounded issue IDs, buried load-bearing statements, and token-wasting preamble. - Issue gloss contract: Enforces a synthesis contract where every tracker issue is rendered with an ID, a plain-English gloss, and unlock-chain consequences, with jargon like "principle 6" or "ADR-N" banned from user-facing text. - Use Case: A delivery agent drafts a morning brief listing held issues as a dense paragraph; run the normalise pass to rewrite it into bold-lead bullets with grounded glosses and release instructions. ## Quick Start Normalise this draft status update to house style and list any violations you fix.

Frequently Asked Questions about faffidavit-rendering

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

FAQPage Schema
How do I validate draft output against a house style guide?▼

Run the validate/normalise pass over the draft as a final step before printing or writing. It returns either a list of violations (where, which rule, the fix) or the rewritten block with fixes applied, depending on how you invoke it.

When should markdown tables be replaced with definition lists?▼

Drop the markdown table when any cell exceeds roughly 30 characters, contains multi-sentence prose, or the total width likely exceeds 80-120 characters. Rewrite each row as key:value lines separated by a unicode box-drawing rule.

Can I add a new visual form for my output?▼

No, the catalogue of canonical visual forms is closed. A skill that needs a new form must add it to the catalogue section first, then use it; inventing visual forms inline is forbidden.

Does this style apply to tracker comments and descriptions?▼

Yes, the rules govern all human-facing output including terminal output, tracker descriptions, and tracker comments. The only carve-outs are skill source files and internal .faff/ logs.

Why are references like ADR numbers banned in user-facing output?▼

Numbered internal references force readers to open documents they have not seen. The humanisation rule requires saying what the ADR or principle decides in plain English, with the identifier allowed only alongside the explanation for traceability.