NavanithanS Type Hints
def get_user(user_id: int) -> Optional[User]:
return db.find(user_id)
Ask Python Refactor
Python refactoring for readability, maintainability, and performance.
Ask Python Refactor by NavanithanS · 9c632aa
npx skillmds@latest add navanithans/ask-python-refactor File contents
---name: ask-python-refactordescription: Python refactoring for readability, maintainability, and performance.---<critical_constraints>❌ NO refactoring without tests first❌ NO single-letter variables (n, x) → use descriptive names❌ NO functions >20 lines → extract smaller functions✅ MUST run tests after every change✅ MUST commit frequently for easy rollback</critical_constraints><naming>Variables: descriptive nouns (user_count not n)Functions: verb + object (calculate_total not calc)Classes: entity nouns (OrderProcessor not OP)</naming><code_smells>- Duplicated code → extract to shared function- Long parameter lists → group into dataclass- Deep nesting → use early returns/guard clauses- Magic numbers → replace with named constants</code_smells><patterns>## Dispatch Tables```python# Before: long if/elif chains# After:handlers = {'a': process_a, 'b': process_b}handler = handlers.get(data.type, process_default)return handler(data)```## Type Hints```pythondef get_user(user_id: int) -> Optional[User]: return db.find(user_id)```</patterns><workflow>1. Ensure tests exist2. Make small changes, verify each step3. Run tests after every change4. Commit frequently5. Review diff before finalizing</workflow>
NavanithanS/Agent-Skill-Kit/tree/main/skills/coding/ask-python-refactor commit 9c632aa633
Frequently asked questions
Run npx skillmds@latest add navanithans/ask-python-refactor in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Python refactoring for readability, maintainability, and performance. It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
NavanithanS (@navanithans) published this skill. Their other Agent Skills are listed on their SkillMD profile.