The Finn-loop: a 3-skill AI software factory for Claude Code — spec, build, review. Humans merge.
Supply asset profile
Code review, repo analysis, testing, CI, GitHub, DevOps, and developer workflow skills.
Scenario
GitHub automation
I need my agent to triage GitHub issues, review pull requests, and summarize repository changes.
Agent fit
Claude Code + CLI + Codex
Codex, Claude Code, Cursor, CLI, or custom agents.
Install
Ready
npx skills add finna/Finn-loop
Maintenance
fresh
2d since push
Risk
Safe to try
Stars/forks activity: 104 stars, 8 forks; issue activity unavailable in current metadata
GitHub quality
104
92/100 quality · 84/100 trust
Coverage tags
Review notes
Stars/forks activity: 104 stars, 8 forks; issue activity unavailable in current metadata
Agent adoption scorecard
These scores combine public repository metadata, OpenAgentSkill review signals, maintenance freshness, and install readiness. They are a shortlist signal, not a replacement for human review.
Quality
ExcellentHigh-confidence pick with strong adoption and healthy maintenance signals.
Trust
Review then installGood shortlist signal, but the agent should review audit notes, install policy, and outcome evidence before running it.
Audit
Safe to tryInstall readiness, security metadata, maintenance, and adoption risk.
Trust Score v5
Use as the primary candidate after human or sandbox review.
Stars
104 GitHub stars
Repo activity
104 stars, 8 forks
Maintenance
2d since push
License
MIT
Install
npx skills add finna/Finn-loop
Install safety
standard package or runtime install path
Permission surface
shell or command execution, filesystem or document access
Agent outcomes
No agent outcome data yet
Docs
Strong README/SKILL.md context
Risk summary
Install readiness
Agent-readable metadata
Use this block or the embedded JSON to decide whether an agent should install this skill, choose an alternative, or ask for human review first.
Suited tasks
Suited agents
Install decision
Trust and risk
Outcome loop
Do not use when
Alternative
164.7K stars
npx skills add mattpocock/skills --skill grill-with-docs
Alternative
168.6K stars
npx skills add mattpocock/skills --skill code-review
Alternative
164.7K stars
npx skills add mattpocock/skills --skill to-spec
Alternative
176.7K stars
npx skills add mattpocock/skills --skill to-tickets
Agent safety v2
Usable candidate, but the agent should surface permission and audit notes before installation.
Require human approval before installing into a real workspace.
high
Skill metadata references terminal, CLI, shell, subprocess, or command execution workflows.
medium
Skill likely fetches remote pages, APIs, repositories, or external services.
medium
Skill may read or write project files, documents, generated artifacts, or local workspace state.
Install targets
Copy the registry command or an agent-specific install prompt for Codex, Claude Code, and Cursor.
Use the registry command when your workflow supports the OpenAgentSkill installer.
$ npx skills add finna/Finn-loopAgent resolve plan
The Resolve API returns the selected skill, alternatives, safety policy, audit notes, install target, and copy-paste prompt an agent can follow without scraping this page.
Resolve JSON
/api/agent/resolve?task=Use%20Finn%20Loop%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Resolve text
/api/agent/resolve?task=Use%20Finn%20Loop%20for%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text
Install handoff
/api/skills/finna-finn-loop/install
Agent should check
Copy prompt
Task: Use Finn Loop in this workspace.
Resolve first: https://www.openagentskill.com/api/agent/resolve?task=Use%20Finn%20Loop%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Review install handoff: https://www.openagentskill.com/api/skills/finna-finn-loop/install
Install command: npx skills add finna/Finn-loop
Before running it, summarize audit warnings, required permissions, and the fallback skill if install is risky.Agent handoff
Use the public install endpoint to fetch the command, safety checklist, target prompts, and canonical links for this skill.
Install handoff
/api/skills/finna-finn-loop/install
LLM text format
/api/skills/finna-finn-loop/install?format=text
Find alternatives
/api/skills/search?q=Finn%20Loop&limit=3
Agent prompt
Use Finn Loop for this task. Review https://www.openagentskill.com/api/skills/finna-finn-loop/install, then install with: npx skills add finna/Finn-loopRegistry metadata
This page exposes the same decision, trust, audit, use-case, and install signals through the Registry API, so agents can rank this skill without scraping the UI.
Manifest
/api/registry/manifest/finna-finn-loop
LLM text
/api/registry/manifest/finna-finn-loop?format=text
Install alias
/api/registry/install/finna-finn-loop
Recommend
/api/registry/recommend?task=Use%20Finn%20Loop%20in%20an%20agent%20workflow&limit=3
Agent fit
GitHub automation
Use-case tags
Platforms
JavaScript, Claude Code
Audit report
Review install readiness, maintenance, trust, quality, and metadata warnings before adding this skill to an agent workflow.
Agent decision cockpit
Use this as a leading candidate, then validate the README and install path in your own agent stack.
Role in stack
Primary pick
Primary fit
GitHub automation
Trust label
Production-ready
Install path
Command ready
Use when
Evidence
Review first
Implementation path
Trust profile
Good shortlist signal, but the agent should review audit notes, install policy, and outcome evidence before running it.
GitHub adoption
INFO104 GitHub stars
Stars/forks activity
CHECK104 stars, 8 forks; issue activity unavailable in current metadata
Recent maintenance
PASS2d since push
License clarity
PASSMIT
Good signals
Review before install
Recommended action
Use as the primary candidate after human or sandbox review.
Quality profile
High-confidence pick with strong adoption and healthy maintenance signals.
Workflow fit
Manage repositories
I need my agent to triage GitHub issues, review pull requests, and summarize repository changes.
Build and ship code
I need a coding agent that can understand a repository, edit code, and review pull requests.
Investigate faster
I need my agent to research a topic, compare sources, and produce a concise report.
Workflow fit
Inspect, patch, and verify code
A workflow for software agents that inspect repositories, review pull requests, generate tests, and turn findings into shippable patches.
Find, compare, and synthesize
A workflow for agents that gather sources, compare claims, summarize long material, and draft useful research briefs.
Turn skills into distribution
A workflow for turning newly indexed skills into SEO briefs, social drafts, comparison pages, and reusable publishing workflows.
Alternative shortlist
Similar skills in this category, ranked with the same readiness and quality signals.
A relentless interview that pressure-tests a plan against the codebase, sharpens domain language, and updates CONTEXT.md and ADRs when decisions become durable.
Review a branch or diff against repository standards and the originating spec in two independent analysis passes.
Turn the current conversation and codebase context into a structured implementation spec, then publish it to the configured project issue tracker.
Break a plan, spec, or conversation into independently actionable tracer-bullet tickets with explicit blocking relationships.
# Finn-loop
Three Claude Code skills that turn Linear + GitHub into a small, human-gated AI software factory:
**idea → `/finn-spec` interviews you and files the issue → you label it `agent-ready` → `/finn-build` claims it and opens a PR → `/finn-review` posts a verdict → you merge.**
Three skills, one approval label, one rule: **humans merge**.
- [`skills/finn-spec`](skills/finn-spec/SKILL.md) — researches the repo, interviews you until the behavior is unambiguous, then files a Linear issue with acceptance criteria (`AC-N`) and non-goals (`NG-N`). - [`skills/finn-build`](skills/finn-build/SKILL.md) — claims the next safe `agent-ready` issue, implements only its contract, verifies it, and opens a PR. Runs repeatedly with `/loop /finn-build`. - [`skills/finn-review`](skills/finn-review/SKILL.md) — reviews open PRs against their linked issue and required GitHub checks, then posts a three-group verdict. Runs repeatedly with `/loop /finn-review`.
The `finn-` prefix avoids collisions with Claude Code's bundled commands and with generic personal skills such as `/review` or `/build`.
## Requirements
- A Git repository hosted on GitHub, with a working `origin` remote - [Claude Code](https://code.claude.com/docs/en/overview) 2.1.71 or newer (`/loop` was added in that release) - A Linear workspace and team - The Linear connector enabled in Claude Code - The GitHub CLI (`gh`) authenticated with write access to the target repo - At least one required GitHub status check if you want fully automated `loop-approved` verdicts; without required CI, Finn-loop escalates the PR for human review
Recommended: connect Linear's [GitHub integration](https://linear.app/docs/github-integration) so linked PRs can update issue status when they open and merge.
## Install
Paste this into Claude Code inside the repo where you want the factory:
```text Set up Finn-loop from https://github.com/finna/Finn-loop.
1. Copy these files from that repo into this repo, preserving
Frameworks & Tools
Decision snapshot
recent repository activity
Audit snapshot
Install and adoption review
Agent-proven evidence
Outcome reports after resolve, review, install, and one narrow run.
No agent outcome data yet. The first agent run can report success, setup needs, risk blocks, failure, or not-relevant through /api/agent/outcome.
Install
Free and open source. Review the audit before production use.
Growth loop
Scenario-led draft for Finn Loop, ready for a manual X post.
Most coding agents don't fail from lack of model power. They fail when repo context disappears. Finn Loop gives coding agents a repeatable way to plan, patch, review, or ship. 104 stars https://www.openagentskill.com/skills/finna-finn-loop?ref=x #AIAgents
Listing + install path for Finn Loop: https://www.openagentskill.com/skills/finna-finn-loop?ref=x Install: npx skills add finna/Finn-loop
Listing source
This listing was indexed from public sources and is not marked official until a maintainer claim is approved.
Attribution links to the public repository or creator profile. Creators can claim the listing to update ownership signals.
Claim this skillOwner claim
This community indexed listing is attributed to finna but is not marked official yet. Claim it to add a verified owner signal and make future launch, install, and audit updates easier to trust.
Creator backlink kit
Show the canonical listing, current trust and audit signals, and real Agent Proven evidence where developers evaluate the repository.
[](https://www.openagentskill.com/skills/finna-finn-loop)
[](https://www.openagentskill.com/skills/finna-finn-loop)
[](https://www.openagentskill.com/skills/finna-finn-loop/audit)
[](https://www.openagentskill.com/skills/finna-finn-loop)finna✓
@finna
Share whether this skill looks useful for your agent workflow. Aggregated feedback improves rankings over time.
Review then install
Grill With Docs
A relentless interview that pressure-tests a plan against the codebase, sharpens domain language, and updates CONTEXT.md and ADRs when decisions become durable.
164.7K stars · 0 installsCode Review
Review a branch or diff against repository standards and the originating spec in two independent analysis passes.
168.6K stars · 0 installsTo Spec
Turn the current conversation and codebase context into a structured implementation spec, then publish it to the configured project issue tracker.
164.7K stars · 0 installsTo Tickets
Break a plan, spec, or conversation into independently actionable tracer-bullet tickets with explicit blocking relationships.
176.7K stars · 0 installs