Code Me Clean Skill Pack

Repository: https://github.com/LaxmanMaharjan/code-me-clean

A cross-agent standards pack that enforces your engineering practices for:

• Python
• JavaScript/TypeScript
• GitHub workflow and release process
• CI/CD and pre-commit quality gates
• Security and dependency hygiene

Acknowledgements

• standards/coding-guidelines.md in this repo was adapted from coding-guidelines.md in forrestchang/andrej-karpathy-skills.
• This project is inspired by JuliusBrussee/caveman.

This repository is organized with a source-and-sync distribution model:

• One source skill file
• One source always-on rule file
• Agent-specific distributed copies

---

What You Get

Feature	Claude	Codex	Gemini CLI	Cursor	Windsurf	Cline	Copilot
Engineering standards skill	Y	Y	Y	Y	Y	Y	Y
Always-on standards activation	Config-based	Context-based	Context-based	Y	Y	Y	Y
Branch/commit/PR/release enforcement guidance	Y	Y	Y	Y	Y	Y	Y
Security + testing + docs guardrails	Y	Y	Y	Y	Y	Y	Y

---

Repository Layout

Source of truth (edit these)

• skills/code-me-clean/SKILL.md
• rules/code-me-clean-activate.md

Standards files and directories

• standards/coding-guidelines.md
• standards/github/
• standards/python/
• standards/javascript/

Distributed files (synced copies/references)

• .github/skills/code-me-clean/SKILL.md
• .claude/skills/code-me-clean/SKILL.md
• .cursor/skills/code-me-clean/SKILL.md
• .windsurf/skills/code-me-clean/SKILL.md
• .agents/skills/code-me-clean/SKILL.md
• .cursor/rules/code-me-clean.mdc
• .windsurf/rules/code-me-clean.md
• .clinerules/code-me-clean.md
• .github/copilot-instructions.md
• AGENTS.md
• GEMINI.md

---

Install

Pick your agent and use the setup below.

Claude

Option A: repo-local

1. Clone https://github.com/LaxmanMaharjan/code-me-clean.
2. Open the repository in your Claude-compatible environment.
3. Keep .claude/skills/code-me-clean/SKILL.md in place.

Option B: central skill tooling (if your runtime supports it)

npx skills add LaxmanMaharjan/code-me-clean

---

Codex

Codex reads context from AGENTS.md, which includes the source skill:

• @./skills/code-me-clean/SKILL.md

Steps:

1. Clone https://github.com/LaxmanMaharjan/code-me-clean.
2. Open it in Codex.
3. Verify AGENTS.md is present at repository root.

---

Gemini CLI

Gemini CLI reads context from GEMINI.md, which includes the source skill:

• @./skills/code-me-clean/SKILL.md

Steps:

1. Clone https://github.com/LaxmanMaharjan/code-me-clean.
2. Open it with Gemini CLI.
3. Verify GEMINI.md is present at repository root.

---

Cursor

Cursor gets always-on behavior via:

• .cursor/rules/code-me-clean.mdc

and skill distribution via:

• .cursor/skills/code-me-clean/SKILL.md

Install command pattern (if using npx skills):

npx skills add LaxmanMaharjan/code-me-clean -a cursor

If your agent setup does not auto-install rules, keep the .cursor/rules/ file in your repo for always-on behavior.

---

Windsurf

Windsurf gets always-on behavior via:

• .windsurf/rules/code-me-clean.md

and skill distribution via:

• .windsurf/skills/code-me-clean/SKILL.md

Install command pattern:

npx skills add LaxmanMaharjan/code-me-clean -a windsurf

---

Cline

Cline uses:

• .clinerules/code-me-clean.md

Install command pattern:

npx skills add LaxmanMaharjan/code-me-clean -a cline

---

Copilot

Copilot always-on behavior is delivered by:

• .github/copilot-instructions.md
• AGENTS.md

Install command pattern:

npx skills add LaxmanMaharjan/code-me-clean -a github-copilot

Copilot works in chat, edits, and coding-agent modes when these files are present in the repository.

---

Any Other Agent (via npx skills)

Use:

npx skills add LaxmanMaharjan/code-me-clean

If symlink creation fails on Windows, use:

npx skills add LaxmanMaharjan/code-me-clean --copy

For agents without native always-on hooks/rules, manually add the contents of rules/code-me-clean-activate.md to that agent's system prompt/rules file.

---

Platform Notes

Windows

• Use PowerShell for commands.
• If symlink creation fails in npx skills, use --copy.
• Ensure your editor has permission to read hidden folders (for .github, .cursor, .claude, etc.).

macOS / Linux

• Standard npx skills add ... flows usually work directly.
• Keep hidden folders version-controlled and committed.

---

How It Enforces Standards

The skill/rule content points to these standards documents:

• standards/coding-guidelines.md (load first at coding start)
• standards/github/workflow.md
• standards/github/cicd.md
• standards/github/pre-commit-hooks.md
• standards/github/release-process.md
• standards/python/ (load only relevant files for the current task)
• standards/javascript/ (load only relevant files for the current task)

For non-trivial tasks, the response contract requires:

• Standards applied
• Checks run
• Robustness notes
• Remaining gaps/risks

---

Maintenance Workflow

When standards change:

1. Update skills/code-me-clean/SKILL.md and/or rules/code-me-clean-activate.md.
2. Sync distributed copies in the same PR.
3. Verify all agent files still point to the source skill/rule content.

Recommended future enhancement:

• Add a CI workflow to auto-sync distributed files from source-of-truth files.

---

Quick Start

1. Clone https://github.com/LaxmanMaharjan/code-me-clean.
2. Keep source files and distributed files intact.
3. Open the repo in your preferred coding agent.
4. Ask the agent to implement any task normally; standards are applied automatically by the configured files.

Slash Command Usage

If your agent supports prompt commands, use:

/code-me-clean

Examples:

• /code-me-clean review this diff for standards compliance
• /code-me-clean fix this Python module and add tests
• /code-me-clean prepare release notes and PR summary

The command maps to .github/prompts/code-me-clean.prompt.md and applies the same standards pack used by the always-on files.