Agent skill

Pre Commit

by wellwelwel in wellwelwel/poku

Run the mandatory pre-commit checks for the poku repository before staging a commit.

MITAuto-check passedTesting & QA

Install Pre Commit

skills CLI
$ npx skills add wellwelwel/poku --skill pre-commit -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install wellwelwel/poku pre-commit --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/wellwelwel/poku.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/pre-commit .claude/skills/pre-commit && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
pre-commit
GitHub stars
1.2k
Token cost
~728 tokens
SKILL.md length
347 words
Files
1
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

Run the mandatory pre-commit checks for the poku repository before staging a commit.

  • Works in 4 steps: npm run typecheck: TypeScript type check… → npm run lint:fix: auto-fixes Biome and… → npm run build: produces lib/ from src/. → …
  • Prepare a commit
  • SKILL.md covers Preconditions, Recommended steps, Runtime-sensitive checks… and Running a subset, plus 2 more sections
  • Calls npm, bun and deno

What it does

Pre Commit is an agent skill from wellwelwel/poku. Run the mandatory pre-commit checks for the poku repository before staging a commit. Use this whenever the user asks to commit, prepare a commit, push, open a PR, or verify a change is ready. Runs typecheck, lint:fix, build, and the local test suite in order, plus runtime-sensitive suites when the change touches runtime detection, isolation, child-process spawning, environment-variable plumbing, or any Bun or Deno specific code path.

Its SKILL.md is about 730 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Testing & QA, covering Test generation, Secrets management and Linting and formatting. It works with Deno, TypeScript, npm and Node.js. The repository describes itself as: 🐷 Poku makes testing easy for Node.js, Bun, Deno, and you at the same time. The licence is MIT.

When your agent uses it

  • Prepare a commit
  • Verify a change is ready

Example prompts

  • “/pre-commit”

Requirements

  • Node.js

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. npm run typecheck: TypeScript type check across the project.
  2. npm run lint:fix: auto-fixes Biome and Prettier. May modify files, which must be restaged.
  3. npm run build: produces lib/ from src/.
  4. npm test: full local Node.js suite.

What it can do on your machine

Read from SKILL.md and the folder at commit e02df0b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm
    • bun
    • deno
    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm and npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Pre Commit loads about 728 tokens when it runs. Until then it costs about 112 tokens; SKILL.md has 347 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~112
When it runs · the whole SKILL.md, loaded when a task matches
~728

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from wellwelwel/poku at commit e02df0b, republished under its MIT licence (© wellwelwel). 347 words, ~728 tokens.

Download SKILL.mdSave it as .claude/skills/pre-commit/SKILL.md (or your agent's skills folder).
name
pre-commit
description
Run the mandatory pre-commit checks for the poku repository before staging a commit. Use this whenever the user asks to commit, prepare a commit, push, open a PR, or verify a change is ready. Runs typecheck, lint:fix, build, and the local test suite in order, plus runtime-sensitive suites when the change touches runtime detection, isolation, child-process spawning, environment-variable plumbing, or any Bun or Deno specific code path.
user-invocable
true

Pre-commit

Guarantee that every commit lands with passing type checks, formatted code, a successful build, and a green local test suite, so no regression in correctness, style, or distributable output reaches the upstream history.

Preconditions

  • On a fork, read CONTRIBUTING.md first.
  • Working tree reflects the change under review (no unrelated edits staged).

Run in this exact order. Any non-zero exit blocks the commit.

  1. npm run typecheck: TypeScript type check across the project.
  2. npm run lint:fix: auto-fixes Biome and Prettier. May modify files, which must be restaged.
  3. npm run build: produces lib/ from src/.
  4. npm test: full local Node.js suite.

Runtime-sensitive checks (conditional)

Run additionally when the change touches runtime detection, isolation, child-process spawning, environment-variable plumbing, or any Bun or Deno specific code path.

  • bun run test:bun: full local Bun suite.
  • deno task test:deno: full local Deno suite.

Running a subset

Direct execution of a single test file:

  • npx tsx <path> or npx tsx src/bin/index.ts <path>
  • bun --bun <path> or bun --bun src/bin/index.ts <path>
  • deno run -A <path> or deno run -A src/bin/index.ts --denoAllow=all <path>

Filter the suite by path:

  • npm test -- --filter=<path>
  • bun run test:bun -- --filter=<path>
  • deno task test:deno -- --filter=<path>

Acceptance criteria

  • All four mandatory steps exit with code 0.
  • Runtime-sensitive suites exit 0 when applicable.
  • Any files rewritten by lint:fix are restaged before commit, so no unstaged formatting deltas remain.

Failure modes

  • typecheck fails: fix the type error at its source. Do not relax tsconfig or add any to silence it.
  • lint:fix rewrites files: restage them and re-run from step 1. If a rule needs to be disabled, justify it in code review, not by skipping the step.
  • build fails: fix the underlying TypeScript or bundler error. The build catches issues npm test does not.
  • npm test fails: fix the test or the code under test. Never bypass with --no-verify or by skipping the test. Treat a modified existing test as a possible regression and prefer adding new tests.
  • Runtime-sensitive suite fails: reproduce locally with the failing runtime before pushing. A Node-only green run does not clear a runtime-sensitive change.

© wellwelwel, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/pre-commit of wellwelwel/poku.

Open the folder on GitHubat commit e02df0b

Compare with similar skills

Pre Commit next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Pre Commit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pre Commit this skillwellwelwel/poku1.2k—~728Automated safety check: PassMIT
Static Code Analysis Typescriptjaktestowac/awesome-copilot-for-testers116—~4.2kAutomated safety check: PassMIT
Deno Runtime and Package Managerdenoland/skills100—~2.7kAutomated safety check: PassMIT
Migrate to Denodenoland/skills100—~2.2kAutomated safety check: WarnMIT
Swpm Manage Commands Argsdeinsoftware/swpm125—~1.5kAutomated safety check: PassMIT
Zizkadb TestZIZKA-AI-SL/ZizkaDB124—~358Automated safety check: PassCustom licence

Similar skills

  • Static Code Analysis Typescript

    jaktestowac/awesome-copilot-for-testers

    Creates, reviews, and modernizes static code analysis setups for Node.js and TypeScript repositories, covering ESLint flat config, typescript-eslint, tsconfig, Prettier, import sorting, Husky…

    116 GitHub stars~4.2k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Official

    Guides writing, running and configuring Deno 2.9+ projects: installing npm and JSR dependencies, permissions, config file precedence and the built-in fmt, lint, test and compile toolchain.

    100 GitHub stars~2.7k tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • Migrate to Deno

    denoland/skills

    Official

    Moves a Node.js, npm, Yarn, pnpm or Bun project to Deno in reversible steps, starting with Deno as the package manager and changing no code unless needed.

    100 GitHub stars~2.2k tokensUpdated 2 mo ago
    DevelopmentAuto-check: warnings
  • Swpm Manage Commands Args

    deinsoftware/swpm

    Manage cmds and args props in SWPM package manager configs (src/packages/managers/.ts), including adding, modifying or removing command and argument mappings across npm, yarn, pnpm, bun, deno.

    125 GitHub stars~1.5k tokensUpdated 4 mo ago
    DevelopmentAuto-check passed
  • Zizkadb Test

    ZIZKA-AI-SL/ZizkaDB

    Run the full ZizkaDB test suite across all layers — lint, Python unit tests, SDK tests, MCP tests, TypeScript tests, and dashboard build verification.

    124 GitHub stars~358 tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Maintain

    openwpm/OpenWPM

    A skill your agent uses to run a periodic codebase-health pass — dependency audit, lint, test suite, dead code / TODO scan, doc freshness, crosslink issue hygiene, and build artifacts.

    1.4k GitHub stars~1.5k tokensUpdated 3 days ago
    Testing & QAAuto-check passed

More from wellwelwel/poku

  • Benchmarking

    wellwelwel/poku

    Empirical performance comparison playbook for poku covering hypothesis lenses, a standalone harness with a byte-identical correctness gate, variant generation, sequential hyperfine measurement…

    1.2k GitHub stars~3k tokensUpdated 3 mo ago
    Auto-check passed
  • Architecture

    wellwelwel/poku

    Architecture deep-dive for poku covering project structure, execution flow, config discovery, runtime detection, and competitive context.

    1.2k GitHub stars~867 tokensUpdated 3 mo ago
    Auto-check passed
  • Documentation

    wellwelwel/poku

    Documentation deep-dive for the poku website covering Docusaurus setup, language policy, feature-to-docs mapping, conventions, JSDoc, and the changelog.

    1.2k GitHub stars~982 tokensUpdated 3 mo ago
    Auto-check passed
  • Engineering

    wellwelwel/poku

    Engineering deep-dive for poku covering performance, code, and security patterns, TypeScript config, build pipeline, developer experience, and CI/CD.

    1.2k GitHub stars~1.4k tokensUpdated 3 mo ago
    Auto-check passed
  • Testing

    wellwelwel/poku

    Testing deep-dive for poku covering test structure, commands, patterns, fixtures, utils, Docker compatibility, and coverage.

    1.2k GitHub stars~1k tokensUpdated 3 mo ago
    Auto-check passed

Questions about Pre Commit

What does Pre Commit do?

Run the mandatory pre-commit checks for the poku repository before staging a commit. Pre Commit is an agent skill from wellwelwel/poku. Run the mandatory pre-commit checks for the poku repository before staging a commit.

When should I use Pre Commit?

Pre Commit fits situations like: prepare a commit; verify a change is ready.

How do I install Pre Commit in Claude Code?

Run `npx skills add wellwelwel/poku --skill pre-commit -a claude-code`. Or copy the skill folder (.claude/skills/pre-commit in wellwelwel/poku) into .claude/skills/pre-commit in your project. Claude Code loads it when a task matches its description.

How do I install Pre Commit in Codex?

Run `npx skills add wellwelwel/poku --skill pre-commit -a codex`. Or copy the skill folder (.claude/skills/pre-commit in wellwelwel/poku) into .agents/skills/pre-commit in your project. Codex loads it when a task matches its description.

Can I use Pre Commit in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add wellwelwel/poku --skill pre-commit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pre-commit, .gemini/skills/pre-commit, .github/skills/pre-commit and .opencode/skills/pre-commit in your project.

What does Pre Commit need to run?

Going by SKILL.md and its folder, Pre Commit needs the command-line tools its instructions call (npm, bun, deno and npx). Our summary lists: Node.js.

Does Pre Commit access the network?

SKILL.md contains no URLs. Its commands use npm and npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Pre Commit safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Pre Commit use?

Pre Commit is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Pre Commit use?

About 728 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Pre Commit?

Skills that share tags, products or a category with Pre Commit: Static Code Analysis Typescript (jaktestowac/awesome-copilot-for-testers, 116 stars), Deno Runtime and Package Manager (denoland/skills, 100 stars), Migrate to Deno (denoland/skills, 100 stars) and Swpm Manage Commands Args (deinsoftware/swpm, 125 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pre Commit?

wellwelwel (a GitHub user) maintains it in wellwelwel/poku, which has 1,183 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on June 18, 2026.

Source: wellwelwel/poku on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.