skill-composition-standards

Enforce house style and IO-contract discipline on Skill documents.

1|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/peterbamuhigire/digital-research-skills --skill skill-composition-standards
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-composition-standards
Source: https://github.com/peterbamuhigire/digital-research-skills/tree/main/skills/skill-composition-standards
Command: npx skills add https://github.com/peterbamuhigire/digital-research-skills --skill skill-composition-standards

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Repository-wide house style and IO-contract discipline are inconsistently applied across Skills, making integration, review, and governance difficult.

Core Features & Use Cases

  • House-style template: standard frontmatter, required sections, and language rules.
  • Input/Output contracts: formal tables that declare artifacts consumed/produced and dependency templates.
  • Depth extraction: long-form topics moved to references/ with 150–400 line references to support audits and review.

Quick Start

Audit or author SKILL.md files by applying the house-style template and update Inputs/Outputs according to the standard.

Frequently Asked Questions about skill-composition-standards

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

FAQPage Schema
How do I enforce consistent documentation standards and IO contracts across repository skills?

To enforce documentation standards and IO contracts, apply a repository-wide house style template specifying required frontmatter, section structures, and formal Inputs/Outputs tables for every Skill unit.

What is the best way to normalize legacy skills for pull request reviews?

Normalizing legacy skills requires auditing their SKILL.md files against house-style rules, updating their Input/Output contract tables, and extracting long-form topics into 150–400 line reference files.

Does skill authoring require extracting long-form topics into separate reference files?

Skill authoring requires depth extraction, meaning long-form topics must be moved into dedicated reference files of 150–400 lines to support audits and maintain concise core documentation.

Can I use standard artifact templates and cross-linking when writing new skills?

You can use standard artifact templates and cross-linking when writing new skills, as the house style mandates specific templates and structural cross-references to maintain integration discipline.

What writing style and validation rules apply to skill documentation?

Skill documentation must follow a no-emoji British-English writing style and pass validator rules that check for required frontmatter, decision rules, and anti-pattern compliance.