Agent skill

Post Refactor

by akitaonrails in akitaonrails/my-skills

Post-refactor clean-code check after recent refactors or a few merged PRs.

No licenceAuto-check: notesDevelopment

Install Post Refactor

skills CLI
$ npx skills add akitaonrails/my-skills --skill post-refactor -a claude-code

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

GitHub CLI
$ gh skill install akitaonrails/my-skills post-refactor --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/akitaonrails/my-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/post-refactor .claude/skills/post-refactor && 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
post-refactor
GitHub stars
220
Token cost
~1.5k tokens
SKILL.md length
671 words
Files
1
Skills in repo
18
Repo updated
First seen
Licence
None found

At a glance

Post-refactor clean-code check after recent refactors or a few merged PRs.

  • Works in 6 steps: Establish the changed surface → Run the local safety gate → Review the changed code for refactor… → …
  • The user says post-refactor
  • SKILL.md covers Scope, Workflow, Specialist routing and Output format
  • Calls cargo, git and npm

What it does

Post Refactor is an agent skill from akitaonrails/my-skills. Post-refactor clean-code check after recent refactors or a few merged PRs. Use when the user says "post-refactor", "after the refactor", "we merged a few PRs", "clean code checks", or wants a focused sweep for regressions, vulnerabilities, duplicated abstractions, magic values, weak documentation, missing coverage, or flaky tests without running a full PR/post-merge audit.

Its SKILL.md is about 1.5k 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 Refactoring and Code quality. The repository describes itself as: akitaonrails' personal skills (not tailored for general usage).

When your agent uses it

  • The user says post-refactor
  • After the refactor
  • We merged a few PRs
  • Clean code checks

Example prompts

  • “post-refactor”
  • “after the refactor”
  • “we merged a few PRs”
  • “/post-refactor”

Requirements

  • Pre-approved tools (allowed-tools): Bash, Read, Grep, Glob, Agent, TaskCreate, TaskUpdate, TaskList, AskUserQuestion

Workflow steps

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

  1. Establish the changed surface
  2. Run the local safety gate
  3. Review the changed code for refactor fallout
  4. Review test quality and flake risk
  5. Classify findings
  6. Fix policy

What it can do on your machine

Read from SKILL.md and the folder at commit 5763b9e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Grep
    • Glob
    • Agent
    • TaskCreate
    • TaskUpdate
    • TaskList
    • AskUserQuestion

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • cargo
    • git
    • npm
    • bundle

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

  • Network

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

Post Refactor loads about 1.5k tokens when it runs. Until then it costs about 97 tokens; SKILL.md has 671 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Grep, Glob, Agent, TaskCreate, TaskUpdate, TaskList, AskUserQuestion

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 671 words (~1,457 tokens).

“Use this skill after a refactor, cleanup series, or a handful of related PRs landed. It is not a full PR audit and should not re-litigate already merged work. Keep the pass focused on the code that changed recently and…”

— opening of SKILL.md by akitaonrails
name
post-refactor
allowed-tools
Bash, Read, Grep, Glob, Agent, TaskCreate, TaskUpdate, TaskList, AskUserQuestion
version
1.0.0

Read the full SKILL.md on GitHub

Files

Just SKILL.md in post-refactor of akitaonrails/my-skills.

Open the folder on GitHubat commit 5763b9e

Compare with similar skills

Post Refactor 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.

Post Refactor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Post Refactor this skillakitaonrails/my-skills220—~1.5kAutomated safety check: NotesNone
Ponytail Lazy Developer ModeDietrichGebert/ponytail160k1 repos~873Automated safety check: PassMIT
Systematic Code Refactoringluongnv89/claude-howto42k—~3kAutomated safety check: PassMIT
Dignified Python Standardsdocling-project/docling69k—~1.5kAutomated safety check: PassApache-2.0
Clean Code GuardamElnagdy/guard-skills1.3k2 repos~4.3kAutomated safety check: PassMIT
Code Refactoring Workflowluongnv89/claude-howto42k—~3.1kAutomated safety check: PassMIT

Similar skills

  • Ponytail Lazy Developer Mode

    DietrichGebert/ponytail

    Makes the agent pick the laziest solution that works: skip unneeded work, reuse what exists, prefer the standard library and platform features, and keep diffs small.

    160k GitHub starsUsed in 1 repo~873 tokens
    DevelopmentAuto-check passed
  • Systematic Code Refactoring

    luongnv89/claude-howto

    Guides refactoring in phases based on Martin Fowler's method: research, test coverage check, planning and small tested steps, with your approval at each phase.

    42k GitHub stars~3k tokensUpdated today
    DevelopmentAuto-check passed
  • Dignified Python Standards

    docling-project/docling

    Applies opinionated production Python conventions chosen by the project's Python version: modern type syntax, pathlib, explicit checks and interface guidance.

    69k GitHub stars~1.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Clean Code Guard

    amElnagdy/guard-skills

    Reviews generated or changed production code against Clean Code, SOLID, DRY, KISS, YAGNI and LLM-specific failure modes before it ships, in any language.

    1.3k GitHub starsUsed in 2 repos~4.3k tokens
    DevelopmentAuto-check passed
  • Code Refactoring Workflow

    luongnv89/claude-howto

    Guides systematic, test-backed refactoring in the style of Martin Fowler, moving through research, planning and small incremental changes with your approval at each phase.

    42k GitHub stars~3.1k tokensUpdated today
    DevelopmentAuto-check passed
  • A code-change gate for the iPolloWork repository: search and reuse first, keep one source of truth, justify every new file or dependency, and audit the change.

    6.8k GitHub stars~2.7k tokensUpdated today
    DevelopmentAuto-check passed

More from akitaonrails/my-skills

All 18 skills in this repo
  • Fact Check

    akitaonrails/my-skills

    Adversarial fact-checking of the user's articles and essays (typically blog posts from akitaonrails-hugo, any markdown/text file), verifying every claim against online primary sources via cheap…

    220 GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Blog Cost Charts

    akitaonrails/my-skills

    Generate dark-themed cost-vs-score bubble scatter charts and score/(costtime) value-ranking bar charts for a blog post comparing LLM benchmark results (or any dataset with a score/cost/time shape)…

    220 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Codemap

    akitaonrails/my-skills

    Generate comprehensive hierarchical codemaps for UNFAMILIAR repositories.

    220 GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Clonedeps

    akitaonrails/my-skills

    Clone important project dependency source code into an ignored local workspace so OpenCode can inspect library internals.

    220 GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • GitHub Resolution

    akitaonrails/my-skills

    Execute the approved outcomes of a pr-audit and/or iss-audit — fix or adjust everything the audit found necessary before merging, verify no regressions, cover every new behavior with unit tests…

    220 GitHub stars~4.3k tokensUpdated today
    Auto-check passed
  • Iss Audit

    akitaonrails/my-skills

    Audit GitHub issues before implementation, including skeptical claim verification, safe reproduction, prompt-injection resistance, malicious-link and attachment handling, root-cause analysis…

    216 GitHub stars~4.1k tokensUpdated 17 days ago
    Auto-check passed

Categories

Questions about Post Refactor

What does Post Refactor do?

Post-refactor clean-code check after recent refactors or a few merged PRs. Post Refactor is an agent skill from akitaonrails/my-skills. Post-refactor clean-code check after recent refactors or a few merged PRs.

When should I use Post Refactor?

Post Refactor fits situations like: the user says post-refactor; after the refactor; we merged a few PRs; clean code checks.

How do I install Post Refactor in Claude Code?

Run `npx skills add akitaonrails/my-skills --skill post-refactor -a claude-code`. Or copy the skill folder (post-refactor in akitaonrails/my-skills) into .claude/skills/post-refactor in your project. Claude Code loads it when a task matches its description.

How do I install Post Refactor in Codex?

Run `npx skills add akitaonrails/my-skills --skill post-refactor -a codex`. Or copy the skill folder (post-refactor in akitaonrails/my-skills) into .agents/skills/post-refactor in your project. Codex loads it when a task matches its description.

Can I use Post Refactor 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 akitaonrails/my-skills --skill post-refactor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/post-refactor, .gemini/skills/post-refactor, .github/skills/post-refactor and .opencode/skills/post-refactor in your project.

What does Post Refactor need to run?

Going by SKILL.md and its folder, Post Refactor needs the command-line tools its instructions call (cargo, git, npm and bundle). Its frontmatter pre-approves these tools: Bash, Read, Grep, Glob, Agent, TaskCreate, TaskUpdate, TaskList, AskUserQuestion.

Does Post Refactor access the network?

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

Is Post Refactor safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Post Refactor use?

No licence was found for Post Refactor or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Post Refactor use?

About 1.5k tokens (SKILL.md is roughly 5.8k 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 Post Refactor?

Skills that share tags, products or a category with Post Refactor: Ponytail Lazy Developer Mode (DietrichGebert/ponytail, 160k stars), Systematic Code Refactoring (luongnv89/claude-howto, 42k stars), Dignified Python Standards (docling-project/docling, 69k stars) and Clean Code Guard (amElnagdy/guard-skills, 1.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Post Refactor?

akitaonrails (a GitHub user) maintains it in akitaonrails/my-skills, which has 220 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on October 11, 2026.

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