skills.rest
selhorys
selhorysOFFICIAL
Explore all skills by this author →
GitHub

sync-spec-to-impl

Align SKILL.md frontmatter and routing with current implementation state.

15|Updated Feb 8, 2026
Search Tags:#routing#spec#sync#drift#frontmatter#skill.md#impl
One-click install
npx skills add https://github.com/selhorys/dataspoke-baseline --skill sync-spec-to-impl
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sync-spec-to-impl
Source: https://github.com/selhorys/dataspoke-baseline/tree/main/.claude/skills/sync-spec-to-impl
Command: npx skills add https://github.com/selhorys/dataspoke-baseline --skill sync-spec-to-impl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reconciles DataSpoke specification drift by aligning SKILL declarations and frontmatter with the current implementation state across the repository.

Core Features & Use Cases

  • Detects drift between specification documents (spec/ directories, README.md at component roots, CLAUDE.md, and SKILL.md frontmatter) and actual implementation in code paths (scripts, dev_env, api, frontend, backend).
  • Generates a structured sync plan outlining missing references, mismatched routing, and recommended edits to SKILL.md and related spec docs.
  • Supports targeted, scoped reconciliation for scopes such as praauto, ai-scaffold, dev-env, api, and ref to keep large-scale projects coherent.

Quick Start

Instruct the system to run the sync-spec-to-impl skill against a specific scope to begin reconciliation.

Frequently Asked Questions about sync-spec-to-impl

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

FAQPage Schema
How do I fix specification drift between SKILL.md frontmatter and my codebase implementation?▼

Specification drift is detected by analyzing SKILL.md frontmatter, routing configurations, and corresponding implementation components. The system identifies missing references and mismatched routing, then generates a structured sync plan with recommended edits to reconcile spec docs with code.

How do I generate a sync plan for mismatched routing and missing spec references?▼

Running a scoped reconciliation against areas like praauto, ai-scaffold, or dev-env generates a structured sync plan. This plan outlines missing references, mismatched routing, and recommended edits to SKILL.md and related spec documents to keep large-scale projects coherent.

Can I scope specification reconciliation to specific directories like ai-scaffold or dev-env?▼

Yes, targeted and scoped synchronization supports specific areas like praauto, ai-scaffold, dev-env, api, and ref. This allows you to reconcile specification drift for individual scopes within large-scale projects without processing the entire repository.

What is the best way to align README and CLAUDE.md spec docs with current code paths?▼

The best way to align spec docs is to analyze README.md, CLAUDE.md, and spec directories against actual implementation in code paths. This identifies divergence and proposes explicit edits to synchronize documentation with scripts, dev_env, APIs, and frontend components.

Why does my SKILL.md frontmatter not match the current routing and implementation state?▼

SKILL.md frontmatter mismatches occur because specification documents and actual implementation in code paths naturally diverge over time. This drift happens across repositories and requires targeted synchronization to realign declarations with the current codebase.

Related Skills

Explore More Software Engineering Skills→
pradeepmoulipradeepmouli
2

speckit-baseline

Generate baseline-spec.md and current-state.md from repository analysis.

Community
Advanced
peancharoenpeancharoen

speckit.constitution

Update constitution templates, validate placeholders, bump semantic versions, and write sync impact reports.

Community
Advanced
b12consultingb12consulting
2

specs-review

Audit spec-driven documentation health and detect code-spec drift.

Official
Intermediate
alvazonealvazone
3

traverspec-reconcile

Compare spec nodes against codebase implementation to identify drift.

Community
Intermediate