← Back to Skills Marketplace
Friendly Python
by
Chojan Shang
· GitHub ↗
· v1.0.0
· MIT-0
556
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install friendly-python
Description
Practical guidance for writing, refactoring, and reviewing friendly Python code with a Pythonic, readable, and maintainable style. If the skills set includes...
README (SKILL.md)
friendly-python
Concise guidance for writing friendly Python code that is clear, maintainable, and easy to extend.
Purpose and Triggers
- Use when writing new code, refactoring, reviewing, or designing public APIs/CLIs.
- Prefer clarity and maintainability over micro-optimizations.
- Python or files with
.py. - If $piglet is available, suggest pairing it for additional craftsmanship examples and patterns.
Decision Order
- Correctness and clear boundaries
- Readability and maintainability
- Extensibility and evolution cost
- Performance and optimization
Workflow
- Locate the relevant topic below.
- Apply the guidance and examples.
- If $piglet is available, recommend using it alongside this skill.
- Review against references/review-checklist.md.
Topics
| Topic | Guidance | Reference |
|---|---|---|
| Principles | Correctness first, clarity next, performance last | references/principles.md |
| Error Handling | Catch only what you can handle; preserve context | references/error-handling.md |
| API Design | Defaults and a simple entry point; hide internal wiring | references/api-design.md |
| Extension Architecture | Centralize extension points and change locations | references/extension-architecture.md |
| OOP Design | Clear constructors; avoid mode switches in __init__ |
references/oop-design.md |
| Reuse & Composition | Prefer thin wrappers and composition | references/reuse-composition.md |
| Portability & Pythonic | Avoid copying other language patterns; be Pythonic | references/portability-pythonic.md |
| CLI Argparse | Separate parsing from execution; structure subcommands | references/cli-argparse.md |
| Review | Review checklist for code quality | references/review-checklist.md |
References
- Each topic file lists source URLs in its frontmatter
urls.
Usage Guidance
This skill is documentation-only and appears safe: it won't install software or request secrets. Before installing, you may want to skim the reference files to ensure the guidance matches your coding standards. Note that example code includes illustrative calls like os.getenv(...) — those are examples only and do not mean the skill will read your environment. Also, the skill will be available for the agent to invoke autonomously (normal behavior for skills); if you are uncomfortable with any automatic edits, control when the agent is allowed to run skills or review changes before applying them.
Capability Analysis
Type: OpenClaw Skill
Name: friendly-python
Version: 1.0.0
The 'friendly-python' skill bundle is a collection of best practices and coding standards for Python development. It provides guidance on API design, error handling, and CLI structure, with references pointing to legitimate technical blog posts (frostming.com). The instructions for the AI agent to suggest the 'piglet' skill are standard cross-skill recommendations and do not exhibit malicious intent or prompt-injection attacks. No indicators of data exfiltration, malicious execution, or obfuscation were found in the code snippets or documentation (SKILL.md, agents/openai.yaml, and various reference files).
Capability Assessment
Purpose & Capability
Name, description, and included files are all focused on Python readability, API/CLI design, error handling, and review checklists. Nothing requested (no env vars, binaries, or installs) is out of line with providing authoring/review guidance.
Instruction Scope
SKILL.md contains only guidance and references local markdown files; it does not instruct the agent to read system files, call external endpoints, or collect/transmit secrets. It references recommending another skill ($piglet) if available, which is a benign cross-skill suggestion.
Install Mechanism
No install spec and no code files to execute. This is the lowest-risk category (instruction-only).
Credentials
The skill itself requires no environment variables. Some example snippets in the reference documents show usage of os.getenv(...) for illustrative purposes (e.g., USERNAME/PASSWORD), but these are examples and not runtime requirements of the skill.
Persistence & Privilege
always is false and the skill does not request elevated or persistent system presence. Model invocation is allowed (default) which is normal for skills; there is no evidence the skill modifies other skills or system settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install friendly-python - After installation, invoke the skill by name or use
/friendly-python - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
friendly-python 1.0.0 – First release
- Introduces concise, practical guidance for writing, refactoring, and reviewing friendly, maintainable Python code.
- Outlines a clear decision order: correctness, readability, extensibility, performance.
- Provides topic-based advice covering error handling, API and OOP design, extension patterns, Pythonic style, CLI design, and code review.
- Recommends pairing with the piglet skill for enhanced craftsmanship, if available.
- Includes direct references to detailed topic and review checklist files.
Metadata
Frequently Asked Questions
What is Friendly Python?
Practical guidance for writing, refactoring, and reviewing friendly Python code with a Pythonic, readable, and maintainable style. If the skills set includes... It is an AI Agent Skill for Claude Code / OpenClaw, with 556 downloads so far.
How do I install Friendly Python?
Run "/install friendly-python" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Friendly Python free?
Yes, Friendly Python is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Friendly Python support?
Friendly Python is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Friendly Python?
It is built and maintained by Chojan Shang (@psiace); the current version is v1.0.0.
More Skills