w3c-technical-reports

Solid

Draft, restructure, or audit specification-style technical reports using an independently expressed reference-only interpretation of W3C editorial guidance. Use for protocols, standards, interoperability documents, conformance requirements, and technical specifications that must separate normative requirements from explanation and define precise, testable behavior without inventing requirements.

Data & Documents 60 stars 2 forks Updated 2 weeks ago MIT

Install

View on GitHub

Quality Score: 83/100

Stars 20%
59
Recency 20%
90
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# W3C technical reports Turn an approved technical design into a precise specification. Improve expression and structure without creating policy, consensus, conformance criteria, or requirements. ## Establish authority and scope - Identify the source of approved requirements and the decision body that owns them. - Preserve requirement strength, actors, conditions, exceptions, algorithms, data types, error behavior, and compatibility constraints. - Do not infer a normative requirement from an example, implementation, issue discussion, preference, or common practice. - Mark unresolved decisions and contradictions as issues. Do not silently choose a behavior. - State the document's scope, out-of-scope concerns, maturity, and intended implementations. ## Build the conceptual model 1. Identify each conformance class, implementation role, data model, and external dependency. 2. Define a term before using it to carry a requirement. Use one stable term per concept. 3. State how terms relate when they can be confused or overlap. 4. Present the processing model in an order that exposes inputs, state changes, outputs, and errors. 5. Keep implementation-specific behavior out unless the scope intentionally requires it. ## Write normative requirements - Give each requirement an identifiable actor and one testable obligation. - Put conditions and scope next to the behavior they constrain. - State exceptions explicitly and identify which rule they override. - Describe observable o...

Details

Author
Neeeophytee
Repository
Neeeophytee/agent-stylebooks
Created
3 weeks ago
Last Updated
2 weeks ago
Language
Python
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

Code & Development Listed

technical-writing

Write, revise, or review substantial technical documentation and design artifacts for a defined reader and task. Use for READMEs, guides, tutorials, how-to documentation, reference material, runbooks, RFCs, ADRs, technical specifications, and implementation plans. Use a design workflow first when future behavior or architecture needs exploration. Use unslop, when available, for small style-only edits. Do not use for code-only work, routine messages, release notes, PR descriptions, commit messages, or verbatim text.

1 Updated today
drafael
Data & Documents Listed

longform-document-design

Design prose-first technical documents — RFCs, design docs, architecture decision records, specifications, postmortems, runbooks, and technical proposals — as self-contained HTML with clear structure, cross-references, footnotes, and clean print output. Use when writing or restructuring a design doc, RFC, ADR, spec, postmortem, or proposal; when a long technical document is hard to navigate or review; or when prose needs a consistent hierarchy, citation, and print treatment. Do not use for metric-led or data-driven reports (use analytical-document-design), for slides (use presentation-design), for standalone charts or diagrams, or for end-user product documentation and tutorials.

2 Updated 2 weeks ago
Avinava
Data & Documents Listed

create-technical-design-document

Use to turn product and system understanding into a technical design document - context, detailed design per component, data and API design, cross-cutting concerns, environments (preview/development/production), alternatives considered, and ADR candidates.

0 Updated 4 days ago
johnoconnor0