# Clean Code

> Enforce human-readable Python with the cleancode analyzer. Use this to check existing files or to generate and validate new code based on instructions.

- **Type:** Skill
- **Install:** `agentstack add skill-lukasb24-clean-code-clean-code`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [LukasB24](https://agentstack.voostack.com/s/lukasb24)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [LukasB24](https://github.com/LukasB24)
- **Source:** https://github.com/LukasB24/clean-code/tree/main/.claude/skills/clean-code

## Install

```sh
agentstack add skill-lukasb24-clean-code-clean-code
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Clean Code Analyzer

Run the `clean-code` static analyzer on the targeted Python file or directory to enforce formatting, structure, and readability standards.

### Workflow

1. **If `target_path` is provided:**
   Execute: `clean-code check "{{target_path}}"`

2. **If no `target_path` is provided but an `instruction` is:**
   * Generate the requested Python code based on the `instruction`.
   * Save the code to a temporary path (`{{generated_file_path}}`).
   * Execute: `clean-code check "{{generated_file_path}}"`

### Guidelines

* By default, `info`-severity violations (the fuzziest, lowest-signal rules) are hidden to avoid context noise. 
* If the summary indicates violations hidden below `--min-severity warning`, and a deeper pass is required, rerun the command with: `clean-code check --min-severity info "{{target_path}}"` (or the generated path).
* Review the output from the analyzer. If any violations are reported, modify the source code directly using the suggested `fix:` patterns. 
* Do not silence violations using inline comments unless specifically requested by the user. 
* `DP701`/`SD801`/`SD802` findings are SOLID/DRY smells, not local style nits — the `fix:` suggestion (extract a shared helper, replace a type-switch with polymorphism/a dispatch table, split a class) usually means introducing a new function/class or changing call sites, not a one-line edit. Apply the refactor, but summarize what you restructured and why when presenting the result, since these findings reshape the code's structure more than the other rules do.
* `DP701` compares functions across every file reached in one `check` run — it still runs (and can still catch within-file duplicates) on a single-file `target_path`, but a single-file check can't see a duplicate living in a sibling file. Prefer checking the containing directory (or the whole project) when hunting for cross-file duplication, not just the one file you touched.
* Present the final cleaned code back to the user.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [LukasB24](https://github.com/LukasB24)
- **Source:** [LukasB24/clean-code](https://github.com/LukasB24/clean-code)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-lukasb24-clean-code-clean-code
- Seller: https://agentstack.voostack.com/s/lukasb24
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.