How do I install the Project Sync Lint skill?

Run npx skillmds add willyu1007/project-sync-lint in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Project Sync Lint safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Project Sync Lint?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Project Sync Lint free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Project Sync Lint?

willyu1007 (@willyu1007) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Project Sync Lint by willyu1007 — Agent Skill

Name: Project Sync Lint
Rating: 4.2 (5 reviews)
Author: willyu1007

Project Sync Lint

Project hub synchronizer and validator. Scans the repo (including multiple dev-docs roots), validates project/task metadata against the Project Contract, and can repair drift by generating missing task identity meta (.ai-task.yaml) and regenerating derived views under .ai/project/<project>/. Works in check-only mode for CI and apply mode for manual repair.

willyu1007 558a11b 6 files · 4.6 KB Updated Sep 10, 2026

File contents

Project Sync/Lint

Purpose

Provide centralized synchronization and validation for the project governance system:

Lint: enforce the Project Contract and detect drift
Sync: generate missing .ai-task.yaml (IDs), upsert registry.yaml, and regenerate derived views
CI: run in check-only mode to block inconsistent changes (errors only; warnings do not fail by default)

This skill is repo governance oriented. It should not implement product code changes.

Commands

All commands are implemented by:

node .ai/scripts/ctl-project-governance.mjs

Init

Create .ai/project/<project>/ files from templates (idempotent).

node .ai/scripts/ctl-project-governance.mjs init --project main

Lint (check-only)

Scan all configured or discovered dev-docs roots and validate the repo against the contract.

node .ai/scripts/ctl-project-governance.mjs lint --check --project main

Sync (dry-run or apply)

Generate missing task identity meta, upsert registry tasks, and regenerate derived views.

node .ai/scripts/ctl-project-governance.mjs sync --dry-run --project main
node .ai/scripts/ctl-project-governance.mjs sync --apply --project main

Optional: append sync-detected events to the hub changelog (append-only; apply-mode only):

node .ai/scripts/ctl-project-governance.mjs sync --apply --project main --changelog

Contract highlights (read the full contract)

Task progress SoT: task bundle 00-overview.md State:
Task identity SoT: .ai-task.yaml task_id
Project semantic SoT: .ai/project/<project>/registry.yaml
Migration: missing .ai-task.yaml is a warning, but invalid/duplicate IDs are errors

Verification

Lint (check-only):
- node .ai/scripts/ctl-project-governance.mjs lint --check --project main
Sync preview (no writes):
- node .ai/scripts/ctl-project-governance.mjs sync --dry-run --project main --init-if-missing
If you changed SSOT skills:
- node .ai/scripts/lint-skills.mjs --strict
- node .ai/scripts/sync-skills.mjs --scope current --providers both --mode reset --yes

Boundaries

Do not edit .codex/skills/ or .claude/skills/ directly (generated).
Do not require Python or third-party dependencies for governance scripts.
Do not treat .ai-task.yaml.status as authoritative for task progress.

---name: project-sync-lintdescription: Project hub synchronizer and validator. Scans the repo (including multiple dev-docs roots), validates project/task metadata against the Project Contract, and can repair drift by generating missing task identity meta (.ai-task.yaml) and regenerating derived views under .ai/project/<project>/. Works in check-only mode for CI and apply mode for manual repair.---# Project Sync/Lint## PurposeProvide **centralized** synchronization and validation for the project governance system:- Lint: enforce the Project Contract and detect drift- Sync: generate missing `.ai-task.yaml` (IDs), upsert `registry.yaml`, and regenerate derived views- CI: run in check-only mode to block inconsistent changes (errors only; warnings do not fail by default)This skill is **repo governance oriented**. It should not implement product code changes.## CommandsAll commands are implemented by:- `node .ai/scripts/ctl-project-governance.mjs`### InitCreate `.ai/project/<project>/` files from templates (idempotent).```bashnode .ai/scripts/ctl-project-governance.mjs init --project main```### Lint (check-only)Scan all configured or discovered `dev-docs` roots and validate the repo against the contract.```bashnode .ai/scripts/ctl-project-governance.mjs lint --check --project main```### Sync (dry-run or apply)Generate missing task identity meta, upsert registry tasks, and regenerate derived views.```bashnode .ai/scripts/ctl-project-governance.mjs sync --dry-run --project mainnode .ai/scripts/ctl-project-governance.mjs sync --apply --project main```Optional: append sync-detected events to the hub changelog (append-only; apply-mode only):```bashnode .ai/scripts/ctl-project-governance.mjs sync --apply --project main --changelog```## Contract highlights (read the full contract)- Task progress SoT: task bundle `00-overview.md` `State:`- Task identity SoT: `.ai-task.yaml` `task_id`- Project semantic SoT: `.ai/project/<project>/registry.yaml`- Migration: missing `.ai-task.yaml` is a warning, but invalid/duplicate IDs are errors## Verification- Lint (check-only): - `node .ai/scripts/ctl-project-governance.mjs lint --check --project main`- Sync preview (no writes): - `node .ai/scripts/ctl-project-governance.mjs sync --dry-run --project main --init-if-missing`- If you changed SSOT skills: - `node .ai/scripts/lint-skills.mjs --strict` - `node .ai/scripts/sync-skills.mjs --scope current --providers both --mode reset --yes`## Boundaries- Do not edit `.codex/skills/` or `.claude/skills/` directly (generated).- Do not require Python or third-party dependencies for governance scripts.- Do not treat `.ai-task.yaml.status` as authoritative for task progress.

Frequently asked questions