| name | squawk |
| description | Alias for the `iago` skill. Appends a Mermaid diagram (sequence, flow, class, or entity-relation) to a GitHub PR's existing /review comment. Use whenever the user invokes /squawk or says "squawk this PR". |
| when_to_use | User invokes /squawk, says "squawk", or asks to append a diagram to a PR review and prefers this alias. |
| argument-hint | [pr-number] [type?] [--mode=append|comment] |
| allowed-tools | ["Bash(gh pr view *)","Bash(gh pr diff *)","Bash(gh pr list *)","Bash(gh api *)","Bash(gh auth status)","Bash(git diff *)","Bash(git log *)","Bash(git rev-parse *)","Read","Grep","Glob"] |
squawk — alias for iago
This skill is a thin alias. The full behavior, rubric, templates, and
helper script live in the iago skill in the same repository.
Do exactly what iago/SKILL.md says. Read that file first, then
follow it step-by-step using the same $ARGUMENTS you received.
Concretely:
- Read
iago/SKILL.md from the sibling directory next to this skill, and
treat it as your operating instructions. The two skills are always
installed side-by-side; the iago/ directory is right next to this
squawk/ directory in whichever skills folder your runtime uses
(~/.claude/skills/, ~/.agents/skills/, ~/.config/opencode/skills/,
etc.).
- Use the helper at
../iago/scripts/post.ts (relative to this skill's
directory), run with bun run, when it's time to post the diagram.
- Use the references and examples under
../iago/ for selection rules and
Mermaid syntax.
Do not duplicate logic here — keep iago as the single source of truth.
