chore: add quick-check skill and document it in AGENTS.md#9955
Conversation
Adds the quick-check Claude Code skill that selects the narrowest lint/type-check/test command for the affected workspace, and documents it in AGENTS.md alongside the existing validation commands. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
There was a problem hiding this comment.
Pull request overview
Adds a Claude Code quick-check skill and links it from AGENTS.md so agents can prefer workspace-scoped validation during iterative development.
Changes:
- Added
.claude/skills/quick-check/SKILL.mdwith workspace-to-command mappings and escalation guidance. - Updated
AGENTS.mdto reference the new quick-check skill under validation commands.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.
| File | Description |
|---|---|
AGENTS.md |
Adds a pointer to the new quick-check skill for scoped validation. |
.claude/skills/quick-check/SKILL.md |
Defines targeted lint, type-check, formatting, and test commands by workspace. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| | Changed paths | Workspace | Quick checks | | ||
| | -------------------------------------------- | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | ||
| | `packages/insomnia/**` | `insomnia` | `npm run lint -w insomnia`, `npm run type-check -w insomnia`, `npm test -w insomnia` | | ||
| | `packages/insomnia-api/**` | `insomnia-api` | `npm run lint -w insomnia-api`, `npm run type-check -w insomnia-api` | | ||
| | `packages/insomnia-inso/**` | `insomnia-inso` | `npm run lint -w insomnia-inso`, `npm run type-check -w insomnia-inso`, `npm run test:unit -w insomnia-inso` | | ||
| | `packages/insomnia-testing/**` | `insomnia-testing` | `npm run lint -w insomnia-testing`, `npm run type-check -w insomnia-testing`, `npm test -w insomnia-testing` | | ||
| | `packages/insomnia-scripting-environment/**` | `insomnia-scripting-environment` | `npm run lint -w insomnia-scripting-environment`, `npm run type-check -w insomnia-scripting-environment`, `npm test -w insomnia-scripting-environment` | | ||
| | `packages/insomnia-smoke-test/**` | `insomnia-smoke-test` | `npm run lint -w insomnia-smoke-test`, `npm run test:dev -w insomnia-smoke-test -- --project=Smoke <optional file>` | |
| | Changed paths | Workspace | Quick checks | | ||
| | -------------------------------------------- | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | ||
| | `packages/insomnia/**` | `insomnia` | `npm run lint -w insomnia`, `npm run type-check -w insomnia`, `npm test -w insomnia` | | ||
| | `packages/insomnia-api/**` | `insomnia-api` | `npm run lint -w insomnia-api`, `npm run type-check -w insomnia-api` | |
✅ Circular References ReportGenerated at: 2026-05-26T07:34:25.825Z Summary
Click to view all circular references in PR (19)Click to view all circular references in base branch (19)Analysis✅ No Change: This PR does not introduce or remove any circular references. This report was generated automatically by comparing against the |
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
| argument-hint: "Provide changed file paths and the desired check type (format, lint, type-check, test), or name the target workspace and what you want validated" | ||
| --- | ||
|
|
||
| ## Workspace Mapping |
There was a problem hiding this comment.
IMO, workspace seems not to be that useful since most changes also affect other workspaces. A full repo npm run lint && npm run type-check && npm test may be more accurate.
arora-r
left a comment
There was a problem hiding this comment.
A personal preference of mine would be to use pre-commit instead of a Claude skill. We can force it to run on every git commit and we can define custom hooks like having a custom script run to find which test files should be ran based on changes.
This is more work but less token usage, especially for bigger changes 😅.
We can configure it to run with a separate command and tell the agent to run this command at the end of all changes to not bother regular development.
| name: quick-check | ||
| description: "Run the smallest useful format, lint, type-check, or test command for the affected Insomnia workspace, and only escalate to broader validation when the change scope justifies it." | ||
| argument-hint: "Provide changed file paths and the desired check type (format, lint, type-check, test), or name the target workspace and what you want validated" |
There was a problem hiding this comment.
It might be worth adding allowed tools to the metadata for the commands it'll use. We can scope to specific commands not purely *. So, npx prettier * instead of npx * - docs
| npm run lint -w <workspace> | ||
| ``` | ||
|
|
||
| ## Targeted Tests |
There was a problem hiding this comment.
Maybe we could also tell it explicitly to either auto-fix or not fix the issues found in tests to be clear on its goals.
|
|
||
| ```bash | ||
| npm run lint && npm run type-check && npm test | ||
| ``` |
There was a problem hiding this comment.
Maybe we can give it an early exit condition section to prevent any spikes.
We could also have it not write everything to the terminal
- eslint --quiet
- npm test --silent
- pipe commands with `| head -50 or 2>&1 | tail -25`
so only errors are shown to lower token usage even more.
Summary
.claude/skills/quick-check/SKILL.md— a Claude Code skill that picks the narrowest lint/type-check/test command for the affected workspace instead of always running repo-wide checks.AGENTS.mdunder Validation Commands so agents know to prefer it during iterative development.Test plan
.claude/skills/quick-check/SKILL.mdis present and matches the local skill definitionAGENTS.mdreference links to the correct path🤖 Generated with Claude Code