Piglet Python Craftsman

Practical Python craftsmanship guidance based on One Python Craftsman. Use when writing, refactoring, or reviewing Python code for naming, branching, data st...

Security Scan

This is an instruction-only Python style-and-review guidance skill that requests no credentials or installs and its contents are consistent with its stated purpose.

Purpose & Capability

The name and description match the provided SKILL.md and reference files: the bundle is a set of Python craftsmanship guidelines and examples. There are no unrelated requirements (no env vars, binaries, or installs) that would be out of scope for a style/review skill.

Instruction Scope

SKILL.md and the reference files are limited to code-quality guidance and do not instruct the agent to read system files, exfiltrate data, or call unknown endpoints. Some examples demonstrate network calls (requests) and file I/O — appropriate as examples of exception handling and I/O guidance — and a few example snippets contain typos/mistakes (e.g., obj.grop, missing imports) that reduce quality but do not indicate malicious intent.

Install Mechanism

No install specification and no code files to execute at install time; this is instruction-only so nothing is written to disk or downloaded during installation.

Credentials

The skill declares no required environment variables, credentials, or config paths. There is no disproportionate secret or credential access requested.

Persistence & Privilege

always is false and the skill is user-invocable (normal). It does not request persistent privileges or attempt to modify other skills or system-wide settings.

Assessment

This skill appears coherent and low-risk: it is an instruction-only Python style guide that asks for no credentials and installs nothing. Before installing, verify the publisher/source and license if provenance is important to you. When using the skill, treat any executable code it suggests as untrusted until you review it — examples include network calls (requests) and file operations, and some snippets contain typos or missing imports, so inspect and run suggested code in a safe environment or with tests rather than blindly executing it. If you want stricter automated checks, consider pairing this skill with established linters or the suggested friendly-python skill.

piglet

Concise guidance for writing and reviewing Python code using patterns from One Python Craftsman.

Purpose and Triggers

• Use for Python (.py) code creation, refactoring, or code review.
• Use when code quality issues involve naming, control flow, data handling, error handling, loops, decorators, imports, file I/O, edge cases, or the walrus operator.
• Prefer clarity and maintainability. Optimize performance only when it is a real constraint.
• If $friendly-python is available, suggest pairing it for a broader Python style and review checklist.

Decision Order

1. Correctness and explicit behavior
2. Readability and maintainability
3. Extension cost and change isolation
4. Performance and micro-optimizations

Workflow

1. Identify the topic in the table below.
2. Apply the guidance and compare against Bad and Good examples.
3. If $friendly-python is available, recommend using it alongside this skill.
4. Re-check for new edge cases and readability regressions.

Topics

Topic	Guidance	Reference
Variables and Naming	Descriptive names, avoid implicit magic, keep variable scope close	references/variables-and-naming.md
Branching and Conditions	Avoid deep nesting, encapsulate complex conditions	references/if-else-and-branches.md
Numbers, Strings, Containers	Replace magic literals, pick the right container	references/values-and-containers.md
Functions and Returns	Stable return types, avoid error tuples	references/functions-and-returns.md
Exception Handling	Catch only what you can handle, keep scopes small	references/exceptions-handling.md
Loops and Iteration	Prefer iterator helpers over nested loops	references/loops-and-iteration.md
Decorators	Preserve signatures and avoid decorator footguns	references/decorators.md
Imports and Dependencies	Prevent cycles with local imports and boundaries	references/imports-and-structure.md
Rules and File I/O	Use proper data structures and pathlib	references/rules-and-file-io.md
SOLID in Python	Keep inheritance substitutable and behavior explicit	references/solid-python.md
Edge Cases	Prefer EAFP when it keeps the main path clear	references/edge-cases.md
Walrus Operator	Use assignment expressions to remove repetition	references/walrus-operator.md

References

• Each reference file lists source URLs in its frontmatter urls.