CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

code-janitor

The Ultimate Senior Fixer. Combines planning, specification, and coding into a single, high-speed execution mode for one-off tasks, ad-hoc fixes, and minor refactors. Bypasses standard SDLC paperwork while strictly enforcing Karpathy-level meticulousness and Ponytail-level simplicity. Trigger via /code-janitor or when the user asks for a quick fix, cleanup, or fast minor feature outside the SDLC process.

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/code-janitor/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured behavioral instruction sheet with concrete directives, a clear sequenced workflow, explicit validation gates, and a well-specified escalation path for complex tasks. Its weaknesses are theatrical persona padding, duplicated rule statements, and hard dependencies on tool names and external files that don't resolve in this environment.

Suggestions

Trim the theatrical padding ("[CRITICAL SYSTEM OVERRIDE]", "in a single breath", "which makes you dangerous if used incorrectly", emoji headers) and keep directives imperative — this targets the lowest-scoring dimension, conciseness.

State the Ponytail ladder once in section 2 and reference it from section 3.1 instead of repeating it, and drop the restated summaries of the Karpathy/Ponytail skills in favor of the already-mandated file reads.

Replace environment-specific tool names (`think`, `grep_search`) with behavior descriptions (e.g., "reason through the change before coding", "search for existing callers") and verify the `.agents/skills/...` and `.agents/standards/...` paths exist, or inline a 2-3 line fallback summary per engine so the skill remains executable when those files are absent.

DimensionReasoningScore

Conciseness

The body is directive-dense (no concept-teaching padding), but it carries noticeable theatrical filler — "[CRITICAL SYSTEM OVERRIDE]", "in a single breath", "which makes you dangerous if used incorrectly" — and restates the Ponytail ladder in both section 2 and 3.1, so it could be tightened well past the minor-trims level of the 4 anchor while being more substantive than the padded level-2 anchor.

3 / 5

Actionability

Guidance is mostly executable as behavior: a literal first output line ("[Activating Persona: Code Janitor]"), a copy-paste escalation response template, a fully specified mini-plan format with naming convention (`janitor-mini-plan-<timestamp>.md`), and a 3-sentence/code/2-sentence output pattern. It falls short of fully executable because it mandates tools ("use the `think` tool", "`grep_search`") that don't exist in this environment and requires reading files (`.agents/skills/karpathy-guidelines/SKILL.md`, `.agents/standards/CONTEXT-FORMAT.md`) that are not present in the bundle.

4 / 5

Workflow Clarity

The One-Shot workflow is a clear numbered sequence (Micro-Spec, Micro-Plan, Execution, Testing) with an explicit validation mandate ("full project test suite MUST pass with zero failures") and a hard approval gate ("strictly forbidden from writing any code... until the user explicitly provides approval") plus a checklist for the complex-task path. It misses the 5 anchor because the error-recovery feedback loop — what to do when the micro-assertion or test suite fails — is implied rather than an explicit validate-fix-retry step.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), but the ~75-line body is well organized under clear numbered sections, and external references are clearly signaled with purpose and path ("Read `.agents/skills/karpathy-guidelines/SKILL.md`"). It stays at 4 rather than 5 because those referenced paths cannot be resolved in the bundle, and content that duplicates them (the Ponytail ladder, the engine summaries) is inlined twice rather than kept in one place.

4 / 5

Total

15

/

20

Passed

Description

78%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description that explicitly answers both what it does and when to use it, with natural trigger phrases and a distinctive anti-SDLC positioning. Its main weakness is buzzword-laden padding ("The Ultimate Senior Fixer", "Karpathy-level", "Ponytail-level") that dilutes the concreteness of its capability statement for readers without that internal context.

DimensionReasoningScore

Specificity

The description lists its domain and actions ("Combines planning, specification, and coding", "ad-hoc fixes, and minor refactors") but pads them with unexplained jargon and fluff ("The Ultimate Senior Fixer", "Karpathy-level meticulousness", "Ponytail-level simplicity") that convey no concrete capability. It names domain plus a few actions, but the actions are generic rather than the distinct concrete operations of the level-4 anchor, so it is not below 3 (actions are more than minimal) nor above it.

3 / 5

Completeness

Both halves are explicit: the what ("Combines planning, specification, and coding into a single, high-speed execution mode for one-off tasks, ad-hoc fixes, and minor refactors") and the when with concrete trigger phrases ("when the user asks for a quick fix, cleanup, or fast minor feature outside the SDLC process"). The when is fully explicit with concrete trigger phrases, so the level-4 anchor's caveat ('when' could be more explicit) does not apply.

5 / 5

Trigger Term Quality

Natural user phrases are present and well chosen: "quick fix, cleanup, or fast minor feature", "one-off tasks, ad-hoc fixes, minor refactors", plus the explicit "/code-janitor" slash trigger. Common variations like "tweak", "patch", "small change", or "bug fix" are missing, which keeps it at good-but-not-comprehensive coverage rather than the 5 anchor's synonym-level coverage; it clearly exceeds the 3 anchor's partial keyword set.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche — one-off/minor work with an explicit contrast against the formal pipeline ("Bypasses standard SDLC paperwork", "outside the SDLC process") — and carries a unique slash trigger, so it is well past the overlap-prone 3 anchor. However, broad terms like "quick fix" and "cleanup" still risk minor collisions with general coding skills, and the SDLC/Karpathy/Ponytail contrasts only disambiguate for users who know that ecosystem, keeping it short of minimal-conflict level 5.

4 / 5

Total

16

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

glenrioariesto/social-content-studio

Path

.agents/skills/code-janitor/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.