Files
meta/skills/skill-check/SKILL.md
T

2.4 KiB

name, description
name description
skill-check Routine compliance audit of the whole jsc skill set with no change request in hand. Sync every domain repo from the Gitea canonical marketplace, audit every skill against the guidelines.md audit checklist via sub agents, confirm each failed item with the user via decision tree, apply the confirmed fixes and re-check until all items pass, then open a PR per affected repo via jsc-git pr. Use for periodic or on-demand compliance checks of the skill set; not for applying a change request (use skillset-update) or editing one skill (use skill-update).

skill-check — audit the skill set against the guidelines

Single source of guidelines: ../../references/guidelines.md.

Flow

  1. Query the Gitea canonical marketplace for the authoritative domain list: run jsc-gitea/tools/gitea.sh api GET /repos/plugins/meta/raw/.claude-plugin/marketplace.json. Clone any domain repo missing from the working directory (gitea.sh clone-url plugins/{domain}) and pull the rest. Completion condition: every domain repo exists locally and is current.
  2. Audit every skill of every domain against the guidelines.md audit checklist — this step MUST run as a sub agent, one sub agent per domain repo. Each sub agent reports its findings: skill, failed checklist item, evidence (file:line), proposed fix. Completion condition: every domain has an audit result.
  3. Present each failed item via the jsc-ask:ask decision tree (apply the proposed fix / skip / custom fix). Every option states its impact scope (example: skipping leaves the skill non-compliant until the next audit). Completion condition: every finding has a recorded decision.
  4. Apply the confirmed fixes — the fix-application part MUST run as a sub agent, one sub agent per affected domain repo: modify the files per the confirmed fix. Then run tools/sync-skill-manifest.sh {domain-path} directly (no sub agent needed) for each affected domain repo to refresh that domain README's 「Skills 目錄」 section and bump the version in all three manifests. Completion condition: every affected repo carries the fixes and the manifest bump.
  5. Re-check the guidelines.md audit checklist for every touched skill. On any failure, return to step 3: confirm and fix again, until all items pass. Completion condition: all checklist items pass.
  6. Call jsc-git:pr once per affected domain repo to open a Push Request. Completion condition: every affected repo has a PR URL.