Transform this Python script into a polished, beginner-friendly project by refactoring the code, adding clear instructional comments, and generating a complete markdown tutorial.
Transform this Python script into a polished, beginner-friendly project by refactoring the code, adding clear instructional comments, and generating a complete markdown tutorial.
Refactor the code
Apply standard Python best practices
Ensure code follows the PEP 8 style guide
Rename unclear variables and functions if needed for clarity
Add comments throughout the code
Use a beginner-friendly, instructional tone
Explain what each part of the code is doing and why it's important
Focus on the logic and reasoning, not just syntax
Avoid redundant or superficial comments
Generate a tutorial as a README.md file Include the following sections:
Project Overview: What the script does and why it's useful
Setup Instructions: Prerequisites, dependencies, and how to run the script
How It Works: A breakdown of the code logic based on the comments
Example Usage: A code snippet showing how to use it
Sample Output: (Optional) Include if the script returns visible results
git-commitgithubExecute git commit with conventional commit message analysis, intelligent staging, and message generation. Use when user asks to commit changes, create a git commit, or mentions "/commit". Supports: (1) Auto-detecting type and scope from changes, (2) Generating conventional commit messages from diff, (3) Interactive commit with optional type/scope/description overrides, (4) Intelligent file staging for logical grouping46 k46 k instalaciones en skills.sh0
excalidraw-diagram-generatorgithubGenerate Excalidraw diagrams from natural language descriptions. Use when asked to "create a diagram", "make a flowchart", "visualize a process", "draw a system architecture", "create a mind map", or "generate an Excalidraw file". Supports flowcharts, relationship diagrams, mind maps, and system architecture diagrams. Outputs .excalidraw JSON files that can be opened directly in Excalidraw.30.8 k30.8 k instalaciones en skills.sh0
documentation-writergithubDiátaxis Documentation Expert. An expert technical writer specializing in creating high-quality software documentation, guided by the principles and structure of the Diátaxis technical documentation authoring framework.27.1 k27.1 k instalaciones en skills.sh0
prdgithubGenerate high-quality Product Requirements Documents (PRDs) for software systems and AI-powered features. Includes executive summaries, user stories, technical specifications, and risk analysis.23.6 k23.6 k instalaciones en skills.sh0
refactorgithubSurgical code refactoring to improve maintainability without changing behavior. Covers extracting functions, renaming variables, breaking down god functions, improving type safety, eliminating code smells, and applying design patterns. Less drastic than repo-rebuilder; use for gradual improvements.22 k22 k instalaciones en skills.sh0
