Agent skill

Finn Build

by finna in finna/Finn-loop

Claim the next safe agent-ready issue from Linear, implement it, and open a PR.

MITAuto-check passedDevelopment

Install Finn Build

skills CLI
$ npx skills add finna/Finn-loop --skill finn-build -a claude-code

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

GitHub CLI
$ gh skill install finna/Finn-loop finn-build --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/finna/Finn-loop.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/finn-build .claude/skills/finn-build && 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
finn-build
GitHub stars
319
Token cost
~1.3k tokens
SKILL.md length
741 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Claim the next safe agent-ready issue from Linear, implement it, and open a PR.

  • Works in 9 steps: Preflight → Review feedback first → Pick → …
  • Asked to run Finn-loops builder
  • SKILL.md covers 0. Preflight, 1. Review feedback first, 2. Pick and 3. Claim (the cooperative lock), plus 5 more sections
  • Calls gh and git

What it does

Finn Build is an agent skill from finna/Finn-loop. Claim the next safe agent-ready issue from Linear, implement it, and open a PR. Use when asked to run Finn-loop's builder, work the approved queue, or fix Finn-loop review feedback. Designed for /loop; one pass does one unit of work.

Its SKILL.md is about 1.3k 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, covering Pull requests. It works with GitHub. The repository describes itself as: The Finn-loop: a 3-skill AI software factory for Claude Code — spec, build, review. Humans merge. The licence is MIT.

When your agent uses it

  • Asked to run Finn-loops builder
  • Work the approved queue
  • Fix Finn-loop review feedback

Example prompts

  • “/finn-build”

Workflow steps

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

  1. Preflight
  2. Review feedback first
  3. Pick
  4. Claim (the cooperative lock)
  5. Read
  6. Build
  7. Verify
  8. Ship
  9. Blocked

What it can do on your machine

Read from SKILL.md and the folder at commit 7941b62. 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:

    • gh
    • git

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

  • Network

    No URLs in SKILL.md. Its commands use gh and git, 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

Finn Build loads about 1.3k tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 741 words of instructions outside code blocks.

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

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 finna/Finn-loop at commit 7941b62, republished under its MIT licence (© finna). 741 words, ~1,313 tokens.

Download SKILL.mdSave it as .claude/skills/finn-build/SKILL.md (or your agent's skills folder).
name
finn-build
description
Claim the next safe agent-ready issue from Linear, implement it, and open a PR. Use when asked to run Finn-loop's builder, work the approved queue, or fix Finn-loop review feedback. Designed for /loop; one pass does one unit of work.

Finn-loop builder

One pass = one unit of work: fix review feedback on one existing PR, or build one issue end to end. Under /loop, each iteration runs this skill once.

0. Preflight

Before changing Linear, GitHub, branches, or files:

  • Confirm this is the intended GitHub repository and origin is reachable.
  • Detect the repository's default branch with gh repo view --json defaultBranchRef --jq .defaultBranchRef.name; never assume it is main.
  • Require a clean working tree (git status --porcelain must be empty). If it is dirty, report the paths and end the pass. Never stash, reset, overwrite, or commit unrelated work.

1. Review feedback first

List open PRs labeled loop-changes-requested, including their labels:

bash
gh pr list --state open --label loop-changes-requested --json number,title,headRefName,headRefOid,labels,updatedAt,url

Skip every PR carrying needs-human-review; it has left the automated repair queue until a human resolves the escalation.

If any PR remains, choose the least recently updated one. Read its linked Linear issue and latest Finn-loop review of COMMIT_SHA verdict. Check out its branch, fix only the "Must fix before merge" items, run the relevant checks, push, remove loop-changes-requested, and comment with what changed. End this pass.

If a proposed fix would cross an issue non-goal or requires a product decision, do not implement it. Comment the exact conflict, add needs-human-review, remove loop-changes-requested, and end the pass. This prevents the next loop iteration from retrying a decision only a human can make.

2. Pick

Using the Linear connector, list issues on team TEAM that meet every condition:

  • labeled agent-ready
  • unassigned
  • not labeled blocked
  • no unresolved blocker relation

Sort by priority, then oldest first. If the queue is empty, say so and end the pass. Do not invent work and do not pick a blocked issue.

3. Claim (the cooperative lock)

Assign yourself and move the issue to the team's started workflow state (prefer In Progress when available). Claim before reading deeply or writing code. Re-fetch the issue immediately after the update; if it is blocked, assigned to somebody else, or no longer agent-ready, do not work it and return to step 2.

The assignee prevents different people from taking the same issue. It is not an atomic lock between simultaneous sessions authenticated as the same Linear user, so only one builder loop may run per team.

4. Read

Fetch the full issue including comments and relations. Implement only its acceptance criteria. Non-goals are binding. Compare every AC-N against every NG-N before editing. No unrelated changes and no opportunistic refactors.

If an acceptance criterion is ambiguous, conflicts with a non-goal, or depends on an unresolved blocker, go to step 8. Never guess.

Show full SKILL.md (320 more words)Show less

5. Build

  • Fetch the latest default branch from origin and create or resume a branch named TEAM-NNN-short-slug, using the issue's real identifier.
  • Implement the acceptance criteria using the repository's existing style, architecture, and naming.
  • Add or update tests when the change affects logic, data flow, permissions, integrations, or user-visible behavior.
  • Preserve behavior outside the issue contract.

6. Verify

Run the project's relevant lint, typecheck, build, and narrowest useful tests. All checks attributable to this change must pass before opening a PR. If a broad check has a pre-existing unrelated failure, run the relevant targeted check, preserve the evidence, and disclose both results in the PR.

Review git diff and git status before shipping. Stop if the diff contains unrelated work or generated secrets.

7. Ship

Push and open a PR with gh pr create. Its description must include:

  • What changed and why
  • Closes TEAM-NNN, using the real Linear issue identifier
  • A scope ledger: one evidence line per AC-N, one preservation line per NG-N, and Other behavior changes: None
  • Numbered manual test steps matching what was actually built
  • Automated checks run and their results
  • Risk: Low / Medium / High

If Other behavior changes: None is not true, stop and get the Linear issue amended before opening the PR.

Comment the PR URL on the Linear issue. Move it to the team's review state if one exists; otherwise leave it in the started state for the Linear-GitHub integration to manage. Never merge and never enable auto-merge. End the pass.

8. Blocked

Comment one specific question a human can answer asynchronously, apply the blocked label, and unassign yourself. Leave agent-ready in place: the pick query explicitly excludes blocked, so the issue safely reappears only after a human answers and removes that label.

Never use "this is unclear" as the question. State the exact decision, the available options, and which acceptance criterion it affects. End the pass so the next iteration can pick different work.

© finna, 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 skills/finn-build of finna/Finn-loop.

Open the folder on GitHubat commit 7941b62

Compare with similar skills

Finn Build 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.

Finn Build compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Finn Build this skillfinna/Finn-loop319—~1.3kAutomated safety check: PassMIT
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Check PRonyx-dot-app/onyx32k2 repos~2.3kAutomated safety check: PassMIT
Contributor-First PR MergeHKUDS/OpenHarness16k1 repos~847Automated safety check: PassMIT
Create Pull Requestcline/cline70k1 repos~1.6kAutomated safety check: PassApache-2.0
Pull Request Title and Body Writeropeninterpreter/openinterpreter69k2 repos~1.1kAutomated safety check: PassApache-2.0

Similar skills

  • 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
  • Check PR

    onyx-dot-app/onyx

    Checks a GitHub, GitLab, or Perforce (p4) pull request (or merge request, or shelved changelist) for unresolved review comments, failing status checks, and incomplete PR descriptions.

    32k GitHub starsUsed in 2 repos~2.3k tokens
    DevelopmentAuto-check passed
  • Merges external GitHub pull requests while keeping the original author credited, and fixes conflicts after the merge instead of rewriting the contribution.

    16k GitHub starsUsed in 1 repo~847 tokens
    DevelopmentAuto-check passed
  • Opens a GitHub pull request from your current branch with the gh CLI, after reviewing the commits and diff and gathering the details the PR needs.

    70k GitHub starsUsed in 1 repo~1.6k tokens
    DevelopmentAuto-check passed
  • Pull Request Title and Body Writer

    openinterpreter/openinterpreter

    Rewrites the title and body of one or more pull requests with gh, leading with why the change was made, then what changed, and describing only the net result.

    69k GitHub starsUsed in 2 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Official

    Runs a loop on a GitHub pull request: fetch review state, triage comments into actions, implement them and resolve threads, repeating until nothing actionable is left.

    48k GitHub stars~2.2k tokensUpdated today
    DevelopmentAuto-check passed

More from finna/Finn-loop

  • Finn Review

    finna/Finn-loop

    Review open PRs against their linked Linear issues and required GitHub checks, then post a three-group verdict with Finn-loop labels.

    319 GitHub stars~1.1k tokensUpdated 2 mo ago
    Auto-check passed
  • Finn Spec

    finna/Finn-loop

    Interview the user about a raw idea until confident, then file a build-ready issue in Linear.

    319 GitHub stars~824 tokensUpdated 2 mo ago
    Auto-check passed

Works with

Categories

Questions about Finn Build

What does Finn Build do?

Claim the next safe agent-ready issue from Linear, implement it, and open a PR. Finn Build is an agent skill from finna/Finn-loop. Claim the next safe agent-ready issue from Linear, implement it, and open a PR.

When should I use Finn Build?

Finn Build fits situations like: asked to run Finn-loops builder; work the approved queue; fix Finn-loop review feedback.

How do I install Finn Build in Claude Code?

Run `npx skills add finna/Finn-loop --skill finn-build -a claude-code`. Or copy the skill folder (skills/finn-build in finna/Finn-loop) into .claude/skills/finn-build in your project. Claude Code loads it when a task matches its description.

How do I install Finn Build in Codex?

Run `npx skills add finna/Finn-loop --skill finn-build -a codex`. Or copy the skill folder (skills/finn-build in finna/Finn-loop) into .agents/skills/finn-build in your project. Codex loads it when a task matches its description.

Can I use Finn Build 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 finna/Finn-loop --skill finn-build -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/finn-build, .gemini/skills/finn-build, .github/skills/finn-build and .opencode/skills/finn-build in your project.

What does Finn Build need to run?

Going by SKILL.md and its folder, Finn Build needs the command-line tools its instructions call (gh and git).

Does Finn Build access the network?

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

Is Finn Build 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 Finn Build use?

Finn Build 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 Finn Build use?

About 1.3k tokens (SKILL.md is roughly 5.3k 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 Finn Build?

Skills that share tags, products or a category with Finn Build: PR Babysitter (openinterpreter/openinterpreter, 69k stars), Check PR (onyx-dot-app/onyx, 32k stars), Contributor-First PR Merge (HKUDS/OpenHarness, 16k stars) and Create Pull Request (cline/cline, 70k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Finn Build?

finna (a GitHub user) maintains it in finna/Finn-loop, which has 319 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on July 23, 2026.

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