Index of every page on this site: llms.txt
All skills
psiace avatar

/piglet

@2265aed
by Chojan Shangpsiace/skills173 stars
7
Run it yourself

Practical Python craftsmanship guidance based on One Python Craftsman. Use when writing, refactoring, or reviewing Python code for naming, branching, data structures, functions, exceptions, loops, decorators, imports, file I/O, edge cases, and modern syntax choices. If the skills set includes friendly-python, suggest invoking it for better Python outcomes.

Use this Skill: https://skilld.dev/gh/psiace/skills/piglet

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈92 tokens for metadata: the name and description. ≈714 when used: this file. ≈3.8k more on demand in 13 files.

Description uses 4.6% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈367 characters, or 4.6%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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.

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts1mo4 checks · Risk SAFE
  • Gen Agent Trust Hub1mo

    The 'piglet' skill provides Python craftsmanship guidance and code examples based on the 'One Python Craftsman' repository. It contains no malicious patterns, unauthorized network operations, or security vulnerabilities.

  • Socket1mo

    No alerts

  • Snyk1mo

    Risk: LOW · No issues

  • Runlayer9mo

    1/14 files flagged

Signed by skilld at 2265aed. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last month.

Steadyupdated 10 months ago

README badge

README badge for psiace/skills/piglet