repo-preflight

Sync repository metadata and create missing changelogs before git commits.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/synapseradio/thinkies --skill repo-preflight
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-preflight
Source: https://github.com/synapseradio/thinkies/tree/main/.claude/skills/repo-preflight
Command: npx skills add https://github.com/synapseradio/thinkies --skill repo-preflight

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, git, and includes scripts (resource) components.

What problem does it solve?

This Skill eliminates the tedious and error-prone manual work of running pre-commit consistency checks. It prevents inconsistent repository states, broken releases, and documentation drift by automatically fixing deterministic issues and reporting problems that require judgment.

Core Features & Use Cases

  • Version Consistency: Automatically syncs marketplace.json with plugin.json versions, ensuring metadata alignment.
  • Skill Count Accuracy: Updates README files with correct skill counts, preventing documentation drift.
  • Changelog Existence: Creates missing CHANGELOG.md files with an initial structure for proper release management.
  • Use Case: Run this Skill before any git commit to ensure your repository's metadata (versions, skill counts, changelogs) is perfectly consistent and ready for integration, saving you from manual fixes later.

Quick Start

Run preflight checks before I commit.