Project Min Evaluation

C3SC0-V4113/Scaffold/skills/project-min-evaluation

by C3SC0-V4113ba1fac59145ed48f727247299ebb09289b87f27bApache-2.03 starsListed Oct 9, 2026Updated Oct 9, 2026Repository updated 3 days ago

Trigger: done, complete, finish, before commit, quality check, verify. Run the project's own minimum quality scripts before claiming work is complete.

Instructions onlySoftware Development
AI-generated overview

Runs a project's own minimum quality scripts before work is reported complete.

What it does
This skill guides an agent to detect a project's package manager, collect the quality scripts defined in package.json, and run them in a fixed order before claiming implementation work is done. It stops at the first failure and reports each script as passed, failed, or not defined, including the exact command and error for failures. It produces a verification report rather than code changes.
When to use it
Use it before reporting implementation work as complete, before committing, or when asked to verify project quality. It fits JavaScript or TypeScript projects that define lint, typecheck, format, test, or similar scripts in package.json.
Requirements
No scripts ship with the skill; it is instructions only. It needs access to the project's package.json and lockfiles, a package manager such as npm, pnpm, or bun, and the project's own quality scripts to be defined.

Project Minimum Evaluation

Activation Contract

Load this skill before reporting implementation work as complete, before committing, or when asked to verify quality.

Hard Rules

  1. Detect the package manager from the project; never hardcode a runner.
  2. Run only scripts defined in package.json scripts; report expected scripts that are missing instead of inventing commands.
  3. Run from the repository root, in the order below, and do not skip a failing step to reach a later one.
  4. Never claim completion while a check fails or was not run.

Decision Gates

Project signalRunner
packageManager field in package.jsonuse the manager it names
pnpm-lock.yamlpnpm run <script>
bun.lock or bun.lockbbun run <script>
package-lock.json, or no other signalnpm run <script>
ScriptRun when
lintalways, if defined
typecheckalways, if defined
format:checkalways, if defined
testalways, if defined
doctoralways, if defined
checkalways, if defined (aggregate gate)
test:e2eonly when end-to-end behavior changed

Execution Steps

  1. Read package.json and the lockfiles to choose the runner.
  2. Collect the scripts from the table that exist in scripts.
  3. Run each existing script in table order with the chosen runner.
  4. Stop at the first failure, fix it, and rerun from that script.

Output Contract

Report each script as passed, failed, or not defined. For a failure or a check that cannot run, give the exact command, the exact error, and the unverified scope.

References

  • references/script-discovery.md [blocked] — detection edge cases.

Source and attribution

Source:C3SC0-V4113/Scaffoldinskills/project-min-evaluationat commitba1fac5

License: Apache-2.0

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal