Skip to content
Back to search

code-quality

MarketplaceWorks with Claude CodeGitHub

Clean, professional, readable code, as a Claude Code skill.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/theophile-wallez--code-quality-skill/badge.svg)](/listings/theophile-wallez--code-quality-skill)

HTML

<a href="/listings/theophile-wallez--code-quality-skill"><img src="/api/listings/theophile-wallez--code-quality-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

With the [`skills`](https://skills.sh) CLI (Claude Code, Codex, Cursor, OpenCode and more):

npx skills add theophile-wallez/code-quality-skill

As a Claude Code plugin:

/plugin marketplace add theophile-wallez/code-quality-skill
/plugin install code-quality@code-quality

Or copy `skills/code-quality` into `~/.claude/skills/` (for every project) or into a project's `.claude/skills/`.

Then ask, for example:

- _"Review this change for code quality."_ - _"Set up linting, formatting and CI for this project."_ - _"Refactor this module so it reads like a senior wrote it."_

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 22 lines
  1. {
  2. "name": "code-quality",
  3. "description": "Clean, professional, readable code, as a Claude Code skill.",
  4. "owner": {
  5. "name": "theophile-wallez"
  6. },
  7. "plugins": [
  8. {
  9. "name": "code-quality",
  10. "source": "./",
  11. "description": "Holds code to a senior engineer's standard: strict types, validated boundaries, small modules, explicit names, few plain comments, tested behavior, modern accessible UI. Rules, a review checklist and ready-made configs, with tools suggested, never imposed.",
  12. "author": {
  13. "name": "theophile-wallez"
  14. },
  15. "version": "1.0.0",
  16. "homepage": "https://github.com/theophile-wallez/code-quality-skill",
  17. "license": "MIT",
  18. "keywords": ["code-quality", "clean-code", "typescript", "linting", "code-review", "shadcn", "tailwind", "accessibility", "agents-md"],
  19. "category": "development"
  20. }
  21. ]
  22. }
README.md · README · 86 lines
  1. # code-quality
  2. An agent skill that holds code to a senior engineer's standard, and sets up
  3. the checks that keep it there. It works with Claude Code, and with any agent
  4. that reads the `SKILL.md` format.
  5. The rules come from a real codebase that had to be rewritten once because a
  6. contributor called it AI-generated and unclean. The skill keeps that from
  7. happening again. Its rules cover:
  8. - **Types:** strict TypeScript, no `any` or `as`, every external input
  9. validated by a schema, states modelled as unions.
  10. - **Structure:** one concern per module, pure logic apart from I/O, short
  11. files and functions, aliases instead of `../`, no import cycles.
  12. - **Names and comments:** names that say what things are, and few short
  13. comments in plain language that say why. No narration and no "AI" voice.
  14. - **Simplicity:** no abstraction before the third use, no wrapper that only
  15. forwards, no defensive checks of impossible cases, no errors swallowed.
  16. - **Errors:** when a plain `try/catch` is enough, when to use a `Result`
  17. type, and when [Effect](https://effect.website) is worth it.
  18. - **Tests:** test behavior on real outputs, and see each test fail once.
  19. - **Modern UI:** shadcn-style primitives, colors only from tokens (in CSS,
  20. Tailwind and code), both color schemes, accessibility, loading, empty and
  21. error states, forms, server state.
  22. - **Production:** security, observability, migrations, pinned toolchains,
  23. least-privilege CI.
  24. - **Workflow:** focused commits, an `AGENTS.md` that holds the rules, and a
  25. definition of done.
  26. Tools are suggested, never imposed. Each rule is written as a principle,
  27. followed by the tools that enforce it: oxlint or ESLint or Biome, oxfmt or
  28. Prettier, zod or Valibot, Vitest, Playwright, knip. A project keeps the
  29. tools it already has.
  30. ## Install
  31. With the [`skills`](https://skills.sh) CLI (Claude Code, Codex, Cursor,
  32. OpenCode and more):
  33. ```bash
  34. npx skills add theophile-wallez/code-quality-skill
  35. ```
  36. As a Claude Code plugin:
  37. ```
  38. /plugin marketplace add theophile-wallez/code-quality-skill
  39. /plugin install code-quality@code-quality
  40. ```
  41. Or copy `skills/code-quality` into `~/.claude/skills/` (for every project) or
  42. into a project's `.claude/skills/`.
  43. Then ask, for example:
  44. - _"Review this change for code quality."_
  45. - _"Set up linting, formatting and CI for this project."_
  46. - _"Refactor this module so it reads like a senior wrote it."_
  47. ## What's inside
  48. - [`SKILL.md`](skills/code-quality/SKILL.md) holds the core rules, how to use
  49. the skill and the definition of done.
  50. - [`references/`](skills/code-quality/references/) has one file per area, with
  51. before/after examples: TypeScript, structure, naming, comments, functions,
  52. simplicity, errors and Effect, testing, tooling, UI, accessibility, app
  53. patterns, security, production, workflow. It also holds a
  54. [review checklist](skills/code-quality/references/review-checklist.md) and
  55. a [setup guide](skills/code-quality/references/setup.md).
  56. - [`assets/`](skills/code-quality/assets/) has configs to copy and adapt:
  57. - `tsconfig.base.json` with the strict options;
  58. - the same lint rules for oxlint and for ESLint;
  59. - oxfmt and `.editorconfig`;
  60. - a Vitest config;
  61. - a script for the rules no linter expresses, with its tests;
  62. - GitHub Actions CI and Dependabot;
  63. - an `AGENTS.md` template;
  64. - a Claude Code hook that blocks heavy or dangerous commands.
  65. The configs were run on a sample project. The oxlint and ESLint configs
  66. catch what the rules forbid and pass clean code, and the source-rules
  67. script's tests pass.
  68. ## License
  69. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.