python-style

Use for package layout under contentstack_management/, setup.py, pylint-friendly style, and imports.

npx skills add https://github.com/contentstack/contentstack-management-python --skill python-style

Python style and repo layout – Contentstack Management Python

When to use

  • Editing any Python under contentstack_management/, setup.py, or requirements.txt.
  • Adding modules or changing how the public package surface is exported.

Instructions

Layout

  • contentstack_management/contentstack.py — Client, Region, user_agents, OAuth wiring.
  • contentstack_management/_api_client.py — _APIClient (HTTP, retries).
  • contentstack_management/stack/ — stack-scoped API surface.
  • Domain modules — entries/, assets/, webhooks/, oauth/, etc.

Style

  • Match existing modules: naming, docstrings, and patterns already used in the same directory.
  • Prefer small, focused changes; keep __init__.py exports consistent with public API intent (README, contentstack_management.__all__).

Imports

  • Use requests (and requests-toolbelt where already used) through _APIClient patterns rather than ad-hoc clients in domain modules unless justified.

Security

  • Do not log authtokens, management tokens, passwords, or API keys; preserve existing header handling in Client.

More skills from contentstack

cms-assets
contentstack
Advise developers on organizing, delivering, and transforming assets in Contentstack. Cover folder structure, Image Delivery API transformations, publishing…
cms-branches-aliases
contentstack
Advise developers on using Contentstack branches for isolated content development and aliases for zero-downtime content deployments. Cover branch strategy,…
cms-data-modeling-best-practices
contentstack
Guide developers to model content in Contentstack using the simplest reusable structure. The skill explains when to use content types, references, global…
cms-live-preview-visual-builder-support-assistant
contentstack
Diagnose and guide Contentstack Live Preview and Visual Builder implementations. Trace preview context, identify the broken contract, and recommend the…
cms-releases
contentstack
Advise developers on using Contentstack Releases for coordinated, atomic content deployment. Cover release creation, item management, staged deployment,…
cms-roles-permissions
contentstack
Advise developers on designing roles, permissions, teams, and token access in Contentstack. Explain built-in roles, custom roles, permission merging,…
cms-taxonomy
contentstack
Advise developers on using Contentstack Taxonomy for structured, hierarchical content classification and delivery-side filtering. Covers taxonomy vs tags,…
cms-tokens-authentication
contentstack
Advise developers on choosing the right Contentstack authentication method and token type for frontend, backend, automation, and third-party app use cases.…