Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
joaquimscosta avatar

Research Frontmatter

  • 1 installs
  • 21 repo stars
  • Updated August 5, 2026
  • joaquimscosta/arkhe-claude-plugins

Enforces a standard YAML frontmatter (title, version, status, created, last_updated) on research documents in docs/research/.

About

Ensures research files carry standard YAML frontmatter so GitHub renders metadata and readers can judge staleness. A developer uses it when creating, editing, or promoting research documents.

  • Five required frontmatter fields
  • Version-increment guidance for content maturity

Research Frontmatter by the numbers

  • 1 all-time installs (skills.sh)
  • Ranked #1,366 of 1,879 Documentation skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/joaquimscosta/arkhe-claude-plugins --skill research-frontmatter

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs1
repo stars21
Last updatedAugust 5, 2026
Repositoryjoaquimscosta/arkhe-claude-plugins

What it does

Enforces a standard YAML frontmatter (title, version, status, created, last_updated) on research documents in docs/research/.

Files

SKILL.mdMarkdownGitHub ↗

Research Frontmatter Standard

Ensure all research files in docs/research/ have standard YAML frontmatter so GitHub renders metadata as a table and readers can judge staleness.

Required Frontmatter

Every research file MUST have these 5 fields at the top of the YAML block:

---
title: "Human-readable title"
version: "1.0.0"
status: Published           # Published | Draft | Living Document
created: YYYY-MM-DD
last_updated: YYYY-MM-DD
---

Additional fields (slug, tags, aliases, promoted_at, last_refreshed, sources) MAY follow the standard fields.

Field Definitions

FieldRequiredFormatDescription
titleYesQuoted stringHuman-readable document title
versionYesSemver stringContent maturity version
statusYesEnumPublished, Draft, or Living Document
createdYesYYYY-MM-DDDate first authored (from git or inline)
last_updatedYesYYYY-MM-DDDate of last substantive content change

When to Increment Version

  • Patch (1.0.0 -> 1.0.1): Typo fixes, formatting, minor clarifications
  • Minor (1.0.0 -> 1.1.0): New sections added, examples updated
  • Major (1.0.0 -> 2.0.0): Complete rewrite, fundamental scope change

README Index

The docs/research/README.md table MUST use these columns:

| Topic | Version | Status | Created | Last Updated |

When adding a new entry, append a row matching this format.

Template

New research files should follow docs/research/TEMPLATE.md.

Validation Checklist

When triggered, verify: 1. File has YAML frontmatter (starts with ---) 2. All 5 required fields are present 3. status is one of the 3 allowed values 4. Dates use ISO 8601 format (YYYY-MM-DD) 5. Standard fields appear before any extra fields 6. README.md entry exists and columns match

Related skills

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.