skills.rest
willyu1007
willyu1007COMMUNITY
Explore all skills by this author →
GitHub

project-sync-lint

Validate and repair project metadata against a Project Contract.

Updated Dec 22, 2025
Search Tags:#automation#project management#ci/cd#validation#synchronization#metadata
One-click install
npx skills add https://github.com/willyu1007/Template-Skill-Basic --skill project-sync-lint
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project-sync-lint
Source: https://github.com/willyu1007/Template-Skill-Basic/tree/main/.claude/skills/workflows/planning/project-sync-lint
Command: npx skills add https://github.com/willyu1007/Template-Skill-Basic --skill project-sync-lint

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill synchronizes project repository metadata, validates it against a defined Project Contract, and can automatically repair inconsistencies by generating missing task metadata and regenerating derived project views.

Core Features & Use Cases

  • Repository Scanning: Scans the entire project repository, including multiple documentation roots.
  • Metadata Validation: Validates project and task metadata against the Project Contract.
  • Automated Repair: Generates missing task identity metadata (.ai-task.yaml) and regenerates derived views.
  • CI/CD Integration: Can operate in a check-only mode for continuous integration pipelines.

Quick Start

Run the project-sync-lint skill in check-only mode to validate the project metadata.

Frequently Asked Questions about project-sync-lint

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

FAQPage Schema
How do I validate project metadata against a defined contract?▼

Run project-sync-lint in check-only mode to validate project metadata against the Project Contract. It scans multiple documentation roots to identify missing task identity metadata and derived view drift.

How do I automatically repair missing task metadata in a repository?▼

Execute the skill in apply mode to repair missing task metadata. It generates missing `.ai-task.yaml` task identity files and regenerates derived project views to resolve repository drift.

Can I run metadata validation in a CI/CD pipeline?▼

Yes, you can integrate metadata validation into CI/CD pipelines using check-only mode. This validates project and task metadata against the Project Contract without applying repairs or modifying files.

What causes project metadata drift across multiple documentation roots?▼

Metadata drift occurs when task identity metadata is missing or outdated across multiple documentation roots. The skill scans these roots to validate against the Project Contract and repair inconsistencies.

Does project-sync-lint work without external dependencies?▼

Yes, the skill operates without external dependencies. It uses internal references to scan repositories, validate metadata against the Project Contract, and regenerate derived views.

Related Skills

Explore More Software Engineering Skills→
nicholasgriffintnnicholasgriffintn
2

add-skill

Create and validate SKILL.md files with YAML frontmatter for OpenCode or Claude.

Community
Basic
yaojingangyaojingang
1.3k

release-hook-dropper

Package release hooks and execute the final release workflow automatically.

Community
Intermediate
haidonglethqbhaidonglethqb

project-management

Coordinate multi-plan project management by synchronizing Claude Tasks with plan files.

Community
Advanced
rabbicserabbicse

test-reliability

Diagnose and repair flaky Playwright end-to-end tests at runtime.

Community
Advanced