skills.rest
pgagarinov
pgagarinovCOMMUNITY
Explore all skills by this author →
Website𝕏@PeterGagarinovGitHub

s1-api-conventions

Enforce Python API coding conventions for the BookStore project.

3|3|Updated Feb 8, 2026
Search Tags:#best practices#api#python#coding standards#conventions#bookstore
One-click install
npx skills add https://github.com/pgagarinov/awesome-claude-code --skill s1-api-conventions
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: s1-api-conventions
Source: https://github.com/pgagarinov/awesome-claude-code/tree/main/examples/05-skills-n-agents/.claude/skills/s1-api-conventions
Command: npx skills add https://github.com/pgagarinov/awesome-claude-code --skill s1-api-conventions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enforces consistent and high-quality Python code standards for the BookStore project, improving maintainability and collaboration.

Core Features & Use Cases

  • Data Model Standards: Ensures proper use of @dataclass, monetary value representation, and type annotations.
  • API Function Guidelines: Dictates return types, status reporting for mutations, and naming conventions.
  • Docstring Requirements: Mandates clear and comprehensive docstrings for all public functions.
  • Error Handling Best Practices: Specifies appropriate exceptions for different error scenarios.
  • Import Organization: Enforces a clean and predictable import structure.

Quick Start

Apply these Python API coding conventions to the BookStore project.

Frequently Asked Questions about s1-api-conventions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What are the best practices for Python API coding conventions in a project?▼

Python API coding conventions enforce consistent standards by mandating @dataclass(slots=True) for models, returning dictionaries for public functions, and organizing imports cleanly to improve project maintainability.

How do I handle monetary values and error handling in Python API functions?▼

Handle monetary values by representing them as integers in cents, and manage errors by raising specific exceptions like ValueError and KeyError based on the scenario to ensure clear API function guidelines.

Does this Python API coding standard require docstrings for all functions?▼

Yes, these Python API coding conventions mandate clear and comprehensive docstrings for all public functions to enforce documentation standards and improve code collaboration across the project.

What is the best way to structure data models in a Python BookStore project?▼

The best way to structure data models in a BookStore project is using @dataclass(slots=True) with proper type annotations, ensuring adherence to strict Python API coding conventions for data models.

Related Skills

Explore More Software Engineering Skills→
dus2183-commitsdus2183-commits

flutter-flow-init

Automate Flutter project initialization by copying templates and validating Android, iOS, and Web builds.

Community
Advanced
CsHengCsHeng
10

language-python

Run Ruff, Mypy, and Pytest checks on Python code.

Community
Advanced
mvillmowmvillmow
18

generate-api-docs

Generate HTML or Markdown API reference docs from docstrings.

Community
Intermediate
deandumdeandum
3

style

Enforce language-agnostic coding style and conventions across a codebase.

Community
Intermediate