Agent skill

Squid Review

Push the committed feature branch, create or update its PR, then run Product Architect acceptance and PR-Reviewer on it.

Apache-2.0Auto-check passedDevelopment

Install Squid Review

skills CLI

$ npx skills add iusztinpaul/squid --skill squid-review -a claude-code

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

GitHub CLI

$ gh skill install iusztinpaul/squid squid-review --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/iusztinpaul/squid.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/squid-review .claude/skills/squid-review && 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/

Paste into Claude Code

Install the "squid-review" agent skill from https://github.com/iusztinpaul/squid/tree/main/skills/squid-review into .claude/skills/squid-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "squid-review", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/iusztinpaul/squid/tree/main/skills/squid-review

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add iusztinpaul/squid --skill squid-review -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install iusztinpaul/squid squid-review --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/iusztinpaul/squid.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/squid-review .agents/skills/squid-review && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "squid-review" agent skill from https://github.com/iusztinpaul/squid/tree/main/skills/squid-review into .agents/skills/squid-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "squid-review", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add iusztinpaul/squid --skill squid-review -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install iusztinpaul/squid squid-review --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/iusztinpaul/squid.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/squid-review .cursor/skills/squid-review && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "squid-review" agent skill from https://github.com/iusztinpaul/squid/tree/main/skills/squid-review into .cursor/skills/squid-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "squid-review", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/iusztinpaul/squid.git --path skills/squid-review

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add iusztinpaul/squid --skill squid-review -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install iusztinpaul/squid squid-review --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/iusztinpaul/squid.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/squid-review .gemini/skills/squid-review && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "squid-review" agent skill from https://github.com/iusztinpaul/squid/tree/main/skills/squid-review into .gemini/skills/squid-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "squid-review", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install iusztinpaul/squid squid-review

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add iusztinpaul/squid --skill squid-review -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/iusztinpaul/squid.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/squid-review .github/skills/squid-review && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "squid-review" agent skill from https://github.com/iusztinpaul/squid/tree/main/skills/squid-review into .github/skills/squid-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "squid-review", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add iusztinpaul/squid --skill squid-review -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install iusztinpaul/squid squid-review --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/iusztinpaul/squid.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/squid-review .opencode/skills/squid-review && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "squid-review" agent skill from https://github.com/iusztinpaul/squid/tree/main/skills/squid-review into .opencode/skills/squid-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "squid-review", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: squid-review
GitHub stars: 203
Token cost: ~873 tokens
SKILL.md length: 300 words
Files: 1
Skills in repo: 13
Repo updated: Sep 3, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

Push the committed feature branch, create or update its PR, then run Product Architect acceptance and PR-Reviewer on it.

Works in 3 steps: Push + create/update the PR → PA acceptance (Any product issues?) → PR-Reviewer (Any Blockers?)
After a features tasks are implemented and committed
SKILL.md covers Step 1 — Push + create/update…, Step 2 — PA acceptance (Any…, Step 3 — PR-Reviewer (Any… and Output
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Squid Review is an agent skill from iusztinpaul/squid. Push the committed feature branch, create or update its PR, then run Product Architect acceptance and PR-Reviewer on it. Output: a clean PR with no blockers, or ONE rollup task. Trigger after a feature's tasks are implemented and committed.

Its SKILL.md is about 870 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 Development. The licence is Apache-2.0.

When your agent uses it

After a features tasks are implemented and committed

Example prompts

“/squid-review”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

Push + create/update the PR
PA acceptance (Any product issues?)
PR-Reviewer (Any Blockers?)

What it can do on your machine

Read from SKILL.md and the folder at commit f5bf6b3. 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
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
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

Squid Review loads about 873 tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 300 words of instructions outside code blocks.

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

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 iusztinpaul/squid at commit f5bf6b3, republished under its Apache-2.0 licence (© iusztinpaul). 300 words, ~873 tokens.

Download SKILL.mdSave it as .claude/skills/squid-review/SKILL.md (or your agent's skills folder).

name: squid-review
description: Push the committed feature branch, create or update its PR, then run Product Architect acceptance and PR-Reviewer on it. Output: a clean PR with no blockers, or ONE rollup task. Trigger after a feature's tasks are implemented and committed.
argument-hint: <feature-title | plan-ref>

Review — push, PA acceptance, PR review

Take the committed feature branch and turn it into a clean, pushed feature PR — or a rollup task describing what to fix. Both gates run on the pushed PR, sequentially: Product Architect (PA) acceptance first, then PR-Reviewer.

You are the orchestrator — a MANAGER. You push, launch the review agents, enforce the gates, and route failures back as rollup tasks. You do NOT review the diff, write code, or merge.

Read AGENTS.md first (tracker mode). Retry caps are below; the Severity Rule lives in the PR-Reviewer's role definition.

Input: a feature branch whose tasks are implemented and committed (the worktree when orchestrated by /squid-implement-night; the current branch when run standalone). Output: a pushed feature PR with NO blockers (Nits appended to the PR description), OR ONE rollup task.

Critical rules:

Never rubber-stamp an ACCEPT or NO BLOCKERS — spot-check the evidence; re-launch with feedback if it's thin.
One rollup task per failed gate, never one ticket per issue.

Step 1 — Push + create/update the PR

Agent(
  subagent_type="squid:software-engineer",
  prompt="""Push feature {title} and open/update its PR per your Push / open PR section. {Working directory: {path}.}
  The PR description summarizes the feature and lists each task by ID. Hand back the PR number."""
)

Capture the PR number for the gates below.

Step 2 — PA acceptance (Any product issues?)

Agent(
  subagent_type="squid:product-architect",
  prompt="""Acceptance review for feature {title} on PR #{N}. Read AGENTS.md first. Follow your acceptance-review role.
  {Working directory: {path}.}
  Walk the feature from the user's perspective against the Tasks Plan's acceptance criteria. Verdict: ACCEPT or REJECT. On REJECT, write ONE rollup task capturing ALL product issues."""
)

ACCEPT (verified) → Step 3.
REJECT → the PA filed ONE rollup task. Return it (see Output).
Cap: PA REJECT max 3 per feature. On the 4th would-be REJECT, stop and surface USER ACTION REQUIRED.

Step 3 — PR-Reviewer (Any Blockers?)

Agent(
  subagent_type="squid:pr-reviewer",
  prompt="""Review PR #{N} (branch feat/{slug}). Read AGENTS.md first. Follow your role definition.
  {Working directory: {path}.}
  Walk every review dimension, including the Simplicity / anti-over-engineering pass. Produce ONE rollup task if there are Blockers; else report NO BLOCKERS and append the Nits to the PR description."""
)

NO BLOCKERS → done. Nits are already on the PR description. Output: the clean pushed PR (#{N}).
Blockers → the PR-Reviewer filed ONE rollup task (Blockers + Nits). Return it (see Output).
Cap: PR-Reviewer max 3 per feature. On the 4th would-be Blockers verdict, stop and surface USER ACTION REQUIRED.

Output

Pass → "Feature PR #{N} clean (no blockers)." Hand to /squid-review-ci (or the human) for CI validation.
Fail → ONE rollup task. The caller (/squid-implement-night) routes it back through /squid-implement-task, then re-invokes /squid-review.

Files

Just SKILL.md in skills/squid-review of iusztinpaul/squid.

Open the folder on GitHubat commit f5bf6b3

Compare with similar skills

Squid Review 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.

Squid Review compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Squid Review this skilliusztinpaul/squid	203	—	~873	Automated safety check: Pass	Apache-2.0	1 mo ago
Vercel Composition Patternssupabase/supabase	111k	58 repos	~726	Automated safety check: Pass	MIT	yesterday
Finishing a Development Branchobra/superpowers	297k	5 repos	~1.9k	Automated safety check: Pass	MIT	yesterday
Typescript Advanced Typesrolling-scopes/rsschool-app	10k	25 repos	~4.2k	Automated safety check: Pass	MPL-2.0	6 days ago
PR Babysitteropeninterpreter/openinterpreter	69k	3 repos	~4.2k	Automated safety check: Pass	Apache-2.0	today
Code Review ChecklistshareAI-lab/learn-claude-code	78k	4 repos	~1.1k	Automated safety check: Pass	MIT	12 days ago

Similar skills

Vercel Composition Patterns
supabase/supabase
Official
React composition patterns that scale. An agent skill from supabase/supabase.
111k GitHub starsUsed in 58 repos~726 tokens
DevelopmentAuto-check passed
Finishing a Development Branch
obra/superpowers
Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.
297k GitHub starsUsed in 5 repos~1.9k tokens
DevelopmentAuto-check passed
Typescript Advanced Types
rolling-scopes/rsschool-app
Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications.
10k GitHub starsUsed in 25 repos~4.2k tokens
DevelopmentAuto-check passed
PR Babysitter
openinterpreter/openinterpreter
Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.
69k GitHub starsUsed in 3 repos~4.2k tokens
DevelopmentAuto-check passed
Code Review Checklist
shareAI-lab/learn-claude-code
Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.
78k GitHub starsUsed in 4 repos~1.1k tokens
DevelopmentAuto-check passed
Greploop
onyx-dot-app/onyx
Iteratively improves a PR (GitHub), MR (GitLab), or shelved changelist (Perforce) until Greptile gives it a 5/5 confidence score with zero unresolved comments.
32k GitHub starsUsed in 4 repos~3.3k tokens
DevelopmentAuto-check passed

More from iusztinpaul/squid

All 13 skills in this repo

Squid Implement Night
iusztinpaul/squid
Run the full agent-team pipeline end-to-end for one feature whose Tasks Plan is already approved by /squid-plan, handing the human a validated, ready-to-squash-merge PR.
203 GitHub stars~1.2k tokensUpdated 1 mo ago
Auto-check passed
Squid Implement Task
iusztinpaul/squid
Implement one task — or a whole list / an approved Tasks Plan — via the inner SWE↔Tester loop, committing each task on PASS.
203 GitHub stars~1.3k tokensUpdated 1 mo ago
Auto-check passed
Squid Review CI
iusztinpaul/squid
Drive CI green on a pushed, review-clean feature PR — On-Call diagnoses failures and hands fix tasks to the SWE.
203 GitHub stars~607 tokensUpdated 1 mo ago
Auto-check passed
Squid Testing Python
iusztinpaul/squid
Write and evaluate effective Python tests using pytest. An agent skill from iusztinpaul/squid.
203 GitHub stars~1.3k tokensUpdated 1 mo ago
Auto-check passed
Squid Architecture Review
iusztinpaul/squid
Periodic architectural sweep — reads existing ADRs, maps modules/dependencies/layering, and reports up to 10 prioritised findings shaped as refactor proposals /squid-refactor can consume directly.
203 GitHub stars~2.6k tokensUpdated 1 mo ago
Auto-check passed
Squid Clean Harness
iusztinpaul/squid
Shrink an agent harness (.agents/ skills + resources) to the minimum tokens that keep the exact same logic.
203 GitHub stars~1.9k tokensUpdated 1 mo ago
Auto-check passed

Questions about Squid Review

What does Squid Review do?

Push the committed feature branch, create or update its PR, then run Product Architect acceptance and PR-Reviewer on it. Squid Review is an agent skill from iusztinpaul/squid. Push the committed feature branch, create or update its PR, then run Product Architect acceptance and PR-Reviewer on it.

When should I use Squid Review?

Squid Review fits situations like: after a features tasks are implemented and committed.

How do I install Squid Review in Claude Code?

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

How do I install Squid Review in Codex?

Run `npx skills add iusztinpaul/squid --skill squid-review -a codex`. Or copy the skill folder (skills/squid-review in iusztinpaul/squid) into .agents/skills/squid-review in your project. Codex loads it when a task matches its description.

Can I use Squid Review 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 iusztinpaul/squid --skill squid-review -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/squid-review, .gemini/skills/squid-review, .github/skills/squid-review and .opencode/skills/squid-review in your project.

What does Squid Review need to run?

SKILL.md names no scripts, command-line tools or credentials: Squid Review is instructions for the agent only.

Does Squid Review access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Squid Review 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 Squid Review use?

Squid Review is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Squid Review use?

About 873 tokens (SKILL.md is roughly 3.5k 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 Squid Review?

Skills that share tags, products or a category with Squid Review: Vercel Composition Patterns (supabase/supabase, 111k stars), Finishing a Development Branch (obra/superpowers, 297k stars), Typescript Advanced Types (rolling-scopes/rsschool-app, 10k stars) and PR Babysitter (openinterpreter/openinterpreter, 69k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Squid Review?

iusztinpaul (a GitHub user) maintains it in iusztinpaul/squid, which has 203 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on September 3, 2026.

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

Install Squid Review

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Review — push, PA acceptance, PR review

Step 1 — Push + create/update the PR

Step 2 — PA acceptance (Any product issues?)

Step 3 — PR-Reviewer (Any Blockers?)

Output

Files

Compare with similar skills

Similar skills

More from iusztinpaul/squid

Related

Questions about Squid Review