Refactor Skill
SkillDocs & knowledgeImprove code readability, enforce idiomatic Kotlin conventions, and enhance documentation quality in S3Mock without changing behavior. Use when asked to clean up code, improve naming, add KDoc, or align with Kotlin/project idioms. Also invoked by the implement and test skills before adding new code to messy areas.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Refactor Skill skill
What this skill tells your AI
The instructions your AI receives, as published by adobe/s3mock in .agents/skills/refactor/SKILL.md and read by ahel’s review.
Entry Criteria
Use to clean up code structure/naming, improve or add KDoc, remove anti-patterns, or prepare code before a feature addition (invoked by the implement/test skill).
Hard constraint: must not change observable behavior. If a change would alter behavior, it belongs in the implement skill instead.
Before Starting
- Read root
AGENTS.mdand the relevant moduleAGENTS.md. - Read callers and tests to understand the code's purpose before making any changes.
- Confirm existing test coverage is sufficient to catch regressions.
Execution Steps
- Apply naming, comment, KDoc, and idiom fixes per docs/KOTLIN.md.
- Run
make testand/ormake integration-teststo verify no behavior changed. - Update the copyright year in every modified file (
INVARIANTS.md). - Invoke the
lintskill.
Completion Criteria
- No behavior changes — tests still pass
- Follows
docs/KOTLIN.mdnaming, comment, and idiom conventions - Copyright year updated in every modified file
- Lint gates pass (via
lintskill)
Resources
AGENTS.md,INVARIANTS.md- Relevant module
AGENTS.md docs/KOTLIN.md
Signals
- GitHub stars
- 1k
- Forks
- 199
- Last commit
- Sep 2026
- Hacker News mentions
- 20
Advanced
- Catalog kind
- skill
- Gateway key
refactor- Source
- github.com/adobe/s3mock