Agent skill

Housekeeper

by axelixlabs in axelixlabs/axelix

Perform housekeeping tasks to manage the complexity of the code base.

LGPL-3.0Auto-check passedDevelopment

Install Housekeeper

skills CLI
$ npx skills add axelixlabs/axelix --skill housekeeper -a claude-code

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

GitHub CLI
$ gh skill install axelixlabs/axelix housekeeper --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/axelixlabs/axelix.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agent_skills/housekeeper .claude/skills/housekeeper && 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
housekeeper
GitHub stars
148
Token cost
~571 tokens
SKILL.md length
323 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
LGPL-3.0

At a glance

Perform housekeeping tasks to manage the complexity of the code base.

  • Works in 6 steps: If unsure - ask. → Do only what has been asked, do not… → The general rule of thumb is the less… → …
  • Asked to perform tasks related to maintenance of the repository
  • SKILL.md covers When to offer this workflow, Overall Principles and Refactoring Tests Code
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Housekeeper is an agent skill from axelixlabs/axelix. Perform housekeeping tasks to manage the complexity of the code base. Use this skill when asked to perform tasks related to maintenance of the repository, refactoring of any kind, management of the technical debt or writing/revisiting tests.

Its SKILL.md is about 570 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 Technical debt and Refactoring. It works with Spring Boot and Java. The repository describes itself as: The source code of Axelix - a Delta Force for your Spring Boot ecosystem. The licence is LGPL-3.0.

When your agent uses it

  • Asked to perform tasks related to maintenance of the repository
  • Refactoring of any kind
  • Management of the technical debt
  • Writing/revisiting tests

Example prompts

  • “/housekeeper”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. If unsure - ask.
  2. Do only what has been asked, do not refactor/enahnce/etc anything else unless asked otherwise.
  3. The general rule of thumb is the less code - the better. Less code generally means less bugs.
  4. Refactoring must NEVER be massive. It involves large risks of breaking existing code, and it is difficult to review. If you can, then make…
  5. Duplication of code is generally bad. Extracting common parts is generally a good thing to be doing.
  6. If you move source files around, please, preserve the author javadoc/tsdoc tags

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

    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

Housekeeper loads about 571 tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 323 words of instructions outside code blocks.

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

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 axelixlabs/axelix at commit f7d043e, republished under its LGPL-3.0 licence (© axelixlabs). 323 words, ~571 tokens.

Download SKILL.mdSave it as .claude/skills/housekeeper/SKILL.md (or your agent's skills folder).
name
housekeeper
description
Perform housekeeping tasks to manage the complexity of the code base. Use this skill when asked to perform tasks related to maintenance of the repository, refactoring of any kind, management of the technical debt or writing/revisiting tests.

Managing the technical debt

The skill provides the structured workflow for managing the technical debt in the project. Act as an active guide, walking users through the stages:

  • Context Gathering
  • Refinement & Structure,
  • Spec Generation
  • Execution

When to offer this workflow

Trigger conditions:

  • User mentions the refactoring of some part of the code
  • User mentions changes in the structure of the files inside the project
  • User mentions any organizational change

Overall Principles

When applying refactoring or making an organizational changes to the code base in overall, follow this strict rules:

  1. If unsure - ask.
  2. Do only what has been asked, do not refactor/enahnce/etc anything else unless asked otherwise.
  3. The general rule of thumb is the less code - the better. Less code generally means less bugs.
  4. Refactoring must NEVER be massive. It involves large risks of breaking existing code, and it is difficult to review. If you can, then make as small and as atomic changes as possible, one at a time.
  5. Duplication of code is generally bad. Extracting common parts is generally a good thing to be doing.
  6. If you move source files around, please, preserve the author javadoc/tsdoc tags

Refactoring Tests Code

When applying refactoring or making an organizational changes to the tests code base, follow this strict rules:

  1. For any given source file A, the dedicated test file for this class must have the name of the A + "Test" postfix, and this test file must reside inside the same Gradle module as the source file.
  2. Tests must cover all the cases declared in the public API.
  3. Ideally, each source file with logic in (not counting DTO/POJO/Java records and similar) should be covered with test cases. But there is a caveat. Sometimes this leads to almost identical Tests and thus the duplication of code, which is bad. So this rule should be handled with care.
  4. Integration tests should be preferred over the unit tests.

© axelixlabs, LGPL-3.0. 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 .agent_skills/housekeeper of axelixlabs/axelix.

Open the folder on GitHubat commit f7d043e

Compare with similar skills

Housekeeper 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.

Housekeeper compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Housekeeper this skillaxelixlabs/axelix148—~571Automated safety check: PassLGPL-3.0
Bootui Java Developmentjdubois/boot-ui315—~1.3kAutomated safety check: PassApache-2.0
Javaericrisco/rsc-harness180—~4.6kAutomated safety check: PassMIT
Java Idiomsirahardianto/awesome-agv156—~1.5kAutomated safety check: PassMIT
Systematic Code Refactoringluongnv89/claude-howto42k—~3kAutomated safety check: PassMIT
Code Simplification for ego-litecitrolabs/ego-lite17k—~1.2kAutomated safety check: PassMIT

Similar skills

  • A skill your agent uses when implementing, debugging, refactoring, or testing existing BootUI Java code, including framework-neutral engine logic, Spring MVC and WebFlux adapters, Quarkus runtime…

    315 GitHub stars~1.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Java

    ericrisco/rsc-harness

    A skill your agent uses when writing, reviewing or refactoring modern Java (21+, 25 LTS) — records and sealed interfaces as algebraic data types, exhaustive pattern-matching switch over instanceof…

    180 GitHub stars~4.6k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Java Idioms

    irahardianto/awesome-agv

    Modern Java (17/21+ LTS) idioms: records, sealed classes, pattern matching switch, Optional hygiene, streams, and JUnit 5 testing.

    156 GitHub stars~1.5k tokensUpdated 6 days ago
    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
  • Finds and implements evidence-backed simplifications in the ego-lite repository, such as dead code, duplicated state and speculative abstractions, without hiding behavior changes.

    17k GitHub stars~1.2k tokensUpdated yesterday
    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

More from axelixlabs/axelix

All 9 skills in this repo
  • Config Breaking Changes

    axelixlabs/axelix

    Review configuration property changes in the Axelix project for breaking changes and migration-policy compliance.

    148 GitHub stars~2.6k tokensUpdated today
    Auto-check passed
  • Backlog Refiner

    axelixlabs/axelix

    Refine and triage GitHub backlog by finding open issues that are stale, obsolete, or resolved by another path.

    148 GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Pick open GitHub issues in the Axelix monorepo that are suitable for unpaid volunteer contributors working in their spare time.

    148 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Prepare Minor Release

    axelixlabs/axelix

    Prepare an Axelix minor lockstep release — the pre-release housekeeping changes, a hand-editable release-notes draft, and the post-release bump to the next -SNAPSHOT.

    148 GitHub stars~2.5k tokensUpdated today
    Auto-check passed
  • Create batched Dependabot-style pull requests for GitHub security findings in axelixlabs/axelix, grouped by dependency surface such as master/front-end, master/build.gradle.kts, or starter Gradle…

    148 GitHub stars~4.2k tokensUpdated today
    Auto-check passed
  • Starter Domain Reviewer

    axelixlabs/axelix

    Reviews changes in sbs/starter-domain for technology-agnostic domain logic, forbidden production dependencies, and Java 11+ compatibility.

    148 GitHub stars~3.3k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Housekeeper

What does Housekeeper do?

Perform housekeeping tasks to manage the complexity of the code base. Housekeeper is an agent skill from axelixlabs/axelix. Perform housekeeping tasks to manage the complexity of the code base.

When should I use Housekeeper?

Housekeeper fits situations like: asked to perform tasks related to maintenance of the repository; refactoring of any kind; management of the technical debt; writing/revisiting tests.

How do I install Housekeeper in Claude Code?

Run `npx skills add axelixlabs/axelix --skill housekeeper -a claude-code`. Or copy the skill folder (.agent_skills/housekeeper in axelixlabs/axelix) into .claude/skills/housekeeper in your project. Claude Code loads it when a task matches its description.

How do I install Housekeeper in Codex?

Run `npx skills add axelixlabs/axelix --skill housekeeper -a codex`. Or copy the skill folder (.agent_skills/housekeeper in axelixlabs/axelix) into .agents/skills/housekeeper in your project. Codex loads it when a task matches its description.

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

What does Housekeeper need to run?

SKILL.md names no scripts, command-line tools or credentials: Housekeeper is instructions for the agent only.

Does Housekeeper access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Housekeeper 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 Housekeeper use?

Housekeeper is published under the LGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Housekeeper use?

About 571 tokens (SKILL.md is roughly 2.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 Housekeeper?

Skills that share tags, products or a category with Housekeeper: Bootui Java Development (jdubois/boot-ui, 315 stars), Java (ericrisco/rsc-harness, 180 stars), Java Idioms (irahardianto/awesome-agv, 156 stars) and Systematic Code Refactoring (luongnv89/claude-howto, 42k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Housekeeper?

axelixlabs (a GitHub organization) maintains it in axelixlabs/axelix, which has 148 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on October 10, 2026.

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