tweaker

tweaker is an agent for Claude Code from skyf0xx/hedgehog. It costs 177 tokens per session (4,231 once invoked), scanned A, original, MIT.

A change-planning agent for Hedgehog projects that have no task currently in progress. It reviews the project’s recorded decisions and handles one change request at a time.

In plain words
What is it for?
Use it for changes such as editing text, changing a colour, adjusting button behaviour, or starting the next piece of work. It can make and commit small changes, while routing larger ones into the project’s planning process.
Why use it?
It lets you adjust a finished or adopted project without carrying the full history of the original build into a new session. It also decides when a change is too large for a simple adjustment and needs broader planning.

Agent for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: model in frontmatter.

Part of the hedgehog plugin — 20 skills, 5 agents, 1 hook shipped together

Good fit Use it for changes such as editing text, changing a colour, adjusting…

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/skyf0xx/hedgehog/tweaker
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/skyf0xx/hedgehog

Made for: Claude Code.

Or install hedgehog, the plugin that ships this one along with the rest of its 20 skills, 5 agents, 1 hook.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for tweaker

README.md
[![agentmods](https://agentmods.dev/badge/agents/skyf0xx/hedgehog/tweaker.svg)](https://agentmods.dev/agents/skyf0xx/hedgehog/tweaker)
Your own site
<a href="https://agentmods.dev/agents/skyf0xx/hedgehog/tweaker"><img src="https://agentmods.dev/badge/agents/skyf0xx/hedgehog/tweaker.svg" alt="Measured on agentmods" height="20"></a>
Per session 177 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 4,231 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00177 $0.04231
Opus 5 $0.00088 $0.02116
Sonnet 5 $0.00035 $0.00846
Haiku 4.5 $0.00018 $0.00423

Measured 7d ago against content hash d8df7cdb188f, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

tweaker scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 7d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

src/agents/tweaker.md · 290 lines

How it starts

The opening of the file, as written. The whole thing — 290 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You are the tweaker role in the Hedgehog discipline. You exist for the session with no build in flight: hedgehog status --brief names no task, and the user now wants to change something — a color, a copy line, a button's behavior, or the next piece of work on a repo Hedgehog was adopted into — without carrying a whole build's context into the conversation. You start from a cleared context on purpose. Re-read the friction log (hedgehog friction list) and the commit log rather than expecting anything to be remembered.

Every core reaches you, the adopted core included. You size a request rather than assuming it: hedgehog-daily reads the installed core's own .hedgehog/core.yaml, which every core has. On an adopted repo, a small single-layer change stops at that gate's tweak exit and is made and committed here; anything above that line routes onward to hedgehog-adopt's "Adding the first (or next) change-work" and hedgehog-authored-loop, per job 1's change-work and re-plan exits below. Adoption is the permanent way change lands on that repo, so both paths stay live there indefinitely — you are not an epilogue.

You have two separate jobs. Don't blend them:

  1. Take tweak requests and make them, one at a time, gated the same way any other Hedgehog change is (read the relevant code, make the smallest correct change, verify it, commit it).
  2. Review the friction log, and separately ask the user for feedback, once per batch of accumulated friction, and — for each real friction pattern and each piece of user feedback actually given — walk the user through turning it into its own GitHub issue against the Hedgehog repo itself (skyf0xx/hedgehog), never the user's own project repo. Friction-sourced issues get bug and help wanted; user-feedback-sourced issues get suggestion.

Job 2 is triggered by the log, not by the session: it runs when at least three rows have been logged since the last reviewed: marker (see Constraints). Below that, skip straight to job 1 — a stray entry or two is not a batch worth interrupting the user for, and it stays in the log for the review that does fire.

Stack (locked)

None of its own — you work inside whichever core's stack is already installed (a shipped core's, the stack an authored core's .hedgehog/core-design.md names, or the existing repo's own stack on an adopted core), editing the same files the core's own build agents would. gh (GitHub CLI) for issue creation only, and only against skyf0xx/hedgehog, never the project's own remote.

Read the full file on GitHub · 290 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 7d ago First seen · 290 lines · 177 tokens per session scan A d8df7cdb188f

Subscribe to this mod's changes

tweaker is an agent published in the GitHub repository skyf0xx/hedgehog (37 stars, last pushed yesterday), licensed MIT. It adds 177 tokens to every session and 4,231 once invoked, about $0.0009 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other agents, from other repositories

spec-reviewer

Verifies implementation matches acceptance criteria by cross-referencing code and test locations. Validates story format and Definition of Ready compliance. Simple PASS/FAIL classification per criterion.

joris887/exosuit · 38 tokens

security-analyst

Attacker-mindset security analysis. Covers OWASP top 10, input validation, secret handling, auth checks, injection, and dependency risks. Reports only findings with confidence >= 80.

joris887/exosuit · 44 tokens

framework-docs-author

Use when drafting or revising framework documentation under agentic-docs/. Owns philosophy.md, spec-driven-development.md, agentic-coding-model.md, automation-decision-framework.md (Skill vs Agent vs Command vs Hook decision matrix), documentation-structure.md, two-tier-docs-pattern.md, multi-vendor-context-files.md…

Enovatr-Labs/SpecRoute · 152 tokens

runtime-architect

Use when building or updating runtime layouts under runtimes/, the MCP single-source-of-truth, or cross-vendor sync utilities under tools/. Owns the six copy-pasteable layouts at runtimes/.claude/, runtimes/.codex/, runtimes/.gemini/, runtimes/.kiro/, runtimes/.cursor/, and runtimes/.devin/, plus runtimes/mcp/…

Enovatr-Labs/SpecRoute · 154 tokens

command-author

Use when drafting or reviewing slash commands under commands/. Owns vendor-specific command templates - command-template.claude.md (markdown body + frontmatter), command-template.gemini.toml (TOML command file with prompt + description). Documents Codex's "skill with user-invocable - true" approach. Ensures per-vendor…

Enovatr-Labs/SpecRoute · 123 tokens

prd-author

Use when drafting, reviewing, or extending PRD content under prds/. Owns the full 23-section enterprise PRD template, the lightweight PRD template, the platform-SRS template, the PRD lifecycle directories (active/deprecated/archive), and example PRDs. Triggers - "draft a PRD template", "fill out prd-template.md"…

Enovatr-Labs/SpecRoute · 118 tokens