Skip to content
Agentmart
Submit a tool

improve

Runs one improvement pass over a project in the direction its north star points, without breaking what it does today: faster in real use, less code, a truer…

Skill by fblissjr

IndexedApache-2.0★ 2
Write a review

Install

Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install skill/fblissjr-improve

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Runs one improvement pass over a project in the direction its north star points, without breaking what it does today: faster in real use, less code, a truer account of what it does, rules that now run as checks. Works with the repo's AGENTS.md sections (North star, Measurement, Reporting, Loop state); state carries between runs in a ledger, bookmarks and a scoreboard; each change lands as its own commit with evidence on a worktree branch; the report leads with what needs the owner. User-invoked only, because a run spends hours and many subagents.

Use cases: documents

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this skill can do and what it asks for, from its SKILL.md. Checked Oct 25, 2026.

Tools
No tools found
Secrets
None asked for
Install scripts
None found

Network hosts it talks to 1

  • codeload.github.com · found in install command

Files it touches

  • ~/.claude/skills/improve

Tools it pre-approves 3

From allowed-tools in SKILL.md: the agent may use these without asking you each time.

  • Bash(python3
  • ${CLAUDE_PLUGIN_ROOT}/scripts/loop_state.py
  • *)

What's inside

Skill name
improve
Description
Runs one improvement pass over a project in the direction its north star points, without breaking what it does today: faster in real use, less code, a truer account of what it does, rules that now run as checks. Works with the repo's AGENTS.md sections (North star, Measurement, Reporting, Loop state); state carries between runs in a ledger, bookmarks and a scoreboard; each change lands as its own commit with evidence on a worktree branch; the report leads with what needs the owner. User-invoked only, because a run spends hours and many subagents.
License
Apache-2.0
Allowed tools
Bash(python3, ${CLAUDE_PLUGIN_ROOT}/scripts/loop_state.py, *)
Instructions
43 lines in SKILL.md · view on GitHub

Before installing

  • Pre-approves some shell commands

Files (2)

  • SKILL.md
  • improvement-loop.md · references/

SKILL.md (first lines)

# Improve

<run>
This skill is a standing prompt. The loop is in
`${CLAUDE_SKILL_DIR}/references/improvement-loop.md`. Read `common.md`, then the loop file, and execute
it as written: it is the instruction set for this run, not background.
</run>

<paths>
- Plugin root: `${CLAUDE_PLUGIN_ROOT}`
- This session's id: `${CLAUDE_SESSION_ID}`
- Shared rules: `${CLAUDE_PLUGIN_ROOT}/references/common.md`. Read it before the loop file.
- Loop-state script: `python3 ${CLAUDE_PLUGIN_ROOT}/scripts/loop_state.py`
- AGENTS.md template: `${CLAUDE_PLUGIN_ROOT}/templates/AGENTS.md`
</paths>

<parameters>
Start from the loop's `<parameters>` block and apply these overrides from the
invocation: $ARGUMENTS

Write the resolved block at the top of the run record before the loop's first
step. An override that names no parameter goes under "Needs from me" rather
than being guessed into one.
</parameters>

<prerequisites>
- The loop cites sections of the repo's AGENTS.md by name. If the repo lacks
  them, the template is at the path above. Propose the
  missing sections under "Needs from me" rather than writing the repo's
  AGENTS.md yourself; its North star is the owner's to set.
- A loop needs things to climb. If the loop state has no scenarios, or the
  run's goal differs from the one they were chosen for, say so under "Needs
  from me" and recommend `/design-scoreboard` before the next run. Build only
  what this run's first ideas need.
</prerequisites>

<after_compaction>
Re-read the loop file and the run state (the ledger and the current run
record) before the next action. The loop's instructions do not survive
compaction on their own; the files do.
</after_compaction>

From fblissjr/fb-claude-skills, Apache-2.0.

More from fblissjr/fb-claude-skills

Signals

Stars
2
Forks
1
Open issues
0
Last commit (this folder)
Sep 24, 2026 (1 month ago)

From GitHub (fetched Oct 24, 2026).

Details

License
Apache-2.0
First seen
Oct 24, 2026
Last checked
Oct 24, 2026

More from fblissjr

Cite this page

improve skill. Agent Mart. https://agentmart.dev/skills/fblissjr-improve (last updated 2026-10-24)