finish-work

Automate a pre-commit checklist for linting, type checks, tests, and documentation.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/MaShouo/CodexAuthExchange --skill finish-work-mashouo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finish-work
Source: https://github.com/MaShouo/CodexAuthExchange/tree/main/.agents/skills/finish-work
Command: npx skills add https://github.com/MaShouo/CodexAuthExchange --skill finish-work-mashouo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates and enforces a rigorous pre-commit checklist to ensure code quality, consistency, and compliance before changes enter the codebase.

Core Features & Use Cases

  • Code Quality: validates linting, type checks, and tests before commit.
  • Code-Spec Sync: keeps documentation and specifications aligned with code changes.
  • Hard Blocks: blocks commits that would violate infra or cross-layer contracts.
  • API/DB/Testing Considerations: prompts review of API changes, migrations, and test coverage.
  • Cross-Layer Verification: ensures robust error handling and end-to-end readiness.
  • Manual Testing: guides targeted exploratory testing before submission.

Quick Start

Run the finish-work checklist to verify linting, tests, and documentation updates before committing.

Frequently Asked Questions about finish-work

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

FAQPage Schema
How do I automate a pre-commit checklist for linting and type checking?

To automate a pre-commit checklist for linting and type checking, you run a validation workflow that executes linting, type checks, and unit tests before a commit. This enforces code quality and prevents broken changes using guardrails with clear error handling.

What is code-spec synchronization and how does it work before a commit?

Code-spec synchronization is the process of keeping documentation and code specifications aligned with actual code changes before commit. It works by verifying that any modifications to the codebase are reflected in the corresponding documentation, ensuring consistency and compliance across the project.

How do I block commits that violate cross-layer contracts or infrastructure rules?

Blocking commits that violate cross-layer contracts or infrastructure rules is achieved by implementing hard blocks within the pre-commit validation workflow. These hard blocks actively prevent the commit operation if the code changes are detected to violate established infra or cross-layer architectural boundaries.

Can I use a pre-commit checklist to review API changes and database migrations?

Yes, a pre-commit checklist can be used to review API changes and database migrations by prompting developers to assess these specific considerations. The workflow actively checks for API modifications, database migrations, and overall test coverage to ensure end-to-end readiness before submission.

Does the pre-commit workflow include guidance for manual exploratory testing?

Yes, the pre-commit workflow includes guidance for manual exploratory testing by prompting targeted testing steps before submission. It ensures robust error handling and end-to-end readiness are verified both automatically and through guided manual testing procedures.

What are the limitations of automating code quality validation before a commit?

Limitations of automating code quality validation include its inability to fully replace manual exploratory testing, as automated checks focus on linting, type safety, and code-spec synchronization. It serves as a guardrail but still requires developer oversight for complex cross-layer verification.