spec-metadata

Generate timestamped Git metadata as YAML frontmatter for research documents.

12|2|Updated Oct 10, 2025
One-click install
npx skills add https://github.com/jeffh/claude-plugins --skill spec-metadata
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-metadata
Source: https://github.com/jeffh/claude-plugins/tree/main/humanlayer/skills/spec-metadata
Command: npx skills add https://github.com/jeffh/claude-plugins --skill spec-metadata

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the inclusion of timestamped, git-backed metadata into documentation, ensuring traceability for research notes, handoffs, and specifications.

Core Features & Use Cases

  • Automated Metadata: Generate date/time, repository name, current branch, and commit hash for YAML frontmatter.
  • Frontmatter Insertion: Produce a ready-to-insert YAML header (date, git_commit, branch, repository, last_updated).
  • Use Case: Attach consistent metadata to thoughts, handoffs, or implementation plans to improve collaboration and traceability.

Quick Start

Use the Spec Metadata Generator to create metadata for a document such as thoughts/shared/research/summary.md and insert it into the file's YAML frontmatter.

Frequently Asked Questions about spec-metadata

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

FAQPage Schema
How do I automatically add Git metadata and timestamps to documentation files?

Spec Metadata generates timestamped Git metadata for documentation by extracting the current date, commit hash, branch, and repository name, then outputs standardized YAML frontmatter ready to insert into your file's header. This ensures traceability across research notes, handoffs, and specifications.

What Git information can I embed in my document frontmatter?

The Skill extracts and embeds five key pieces of metadata: timestamp (date and time), Git commit hash, current branch name, repository name, and last-updated timestamp. These populate a structured YAML frontmatter block for consistent documentation tracking.

Can I use this Skill with both Git and jj version control?

Yes, Spec Metadata supports both Git and jj tooling to collect repository metadata. The Skill queries whichever version control system your project uses and outputs the same standardized YAML frontmatter format.

How do I add metadata to research documents and handoff files?

Run the Spec Metadata Generator on your target document path (e.g., thoughts/shared/research/summary.md or thoughts/shared/handoffs/document.md), and it generates a ready-to-insert YAML header. Copy the output and paste it at the top of your file to attach Git-backed metadata.

Why should I include Git metadata in documentation?

Git-backed metadata improves collaboration and traceability by recording exactly when a document was written, which commit it relates to, and what branch it was on. This is critical for research notes, handoffs, and specifications where context and version history matter.

Do I need to manually track commits and timestamps in my documents?

No. Spec Metadata automates timestamp and commit collection, eliminating manual entry. The Skill queries your version control system directly, so metadata is always accurate and current without extra effort.