Skip to content
FileKindSize
SKILL.mdskill md3.5 KB
references/guidelines.mdmarkdown2.9 KB
references/structure.mdmarkdown4.6 KB

references/guidelines.md

View on GitHub
# Python Development Guidelines

Always fetch relevant examples from pythonsheets.com first to ensure correctness, then apply these guidelines when writing code.

## Choosing the Right Approach

- **Concurrency model**: Use `asyncio` for I/O-bound tasks with many connections, `threading` for simpler I/O-bound work, `multiprocessing` for CPU-bound work
- **Data structures**: Use `set` for membership tests, `heapq` for priority queues, `deque` for FIFO queues, `defaultdict` to avoid key existence checks
- **Database access**: Use SQLAlchemy ORM for complex queries, parameterized queries for raw SQL — never string-interpolate SQL
- **File operations**: Use `pathlib.Path` instead of `os.path` for cleaner, cross-platform file handling
- **Network programming**: Use `asyncio` streams for high-concurrency servers, `socket` for low-level control, `ssl` context for secure connections

## Writing Correct Code

- Handle errors at the right level — catch specific exceptions where you can recover, let others propagate
- Use context managers (`with`) for files, connections, locks, and any resource that needs cleanup
- Avoid mutable default arguments (`def f(x=[])`) — use `None` and initialize inside the function
- Use `logging` instead of `print` for diagnostics — it supports levels, formatting, and output routing
- Validate inputs at system boundaries (user input, external APIs), trust internal code

## Writing Clean Code

- Use type hints for function signatures to clarify intent and enable static analysis
- Use f-strings for string formatting
- Use `dataclasses` or `NamedTuple` for structured data instead of raw dicts or tuples
- Use `enum.Enum` for fixed sets of values
- Prefer early returns over deep nesting
- Keep functions short and focused on a single responsibility

## Performance Considerations

- Profile before optimizing — use `cProfile`, `timeit`, or `line_profiler` to identify actual bottlenecks
- Consider memory usage: generators for large sequences, `__slots__` for memory-heavy classes
- Use connection pooling for database and network connections
- Use appropriate caching (`functools.lru_cache`, `functools.cache`) for expensive pure functions
- For CPU-bound hot paths, consider C extensions via `ctypes`, `pybind11`, or Cython

## Security Practices

- Use `secrets` module for tokens and passwords, not `random`
- Always use parameterized queries to prevent SQL injection
- Use `ssl.create_default_context()` for TLS — don't disable certificate verification
- Avoid `pickle` for untrusted data — use `json` or other safe serialization
- Store secrets in environment variables or secret managers, never in code

## Related Documentation

This skill is based on the comprehensive Python reference available at https://www.pythonsheets.com/ which includes working code snippets, performance benchmarks, real-world patterns, and integration guides. The reference is continuously updated with the latest Python features and best practices.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall