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.pyClient, Region, user_agents, OAuth wiring.
  • contentstack_management/_api_client.py_APIClient (HTTP, retries).
  • contentstack_management/stack/ — stack-scoped API surface.
  • Domain modulesentries/, 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

brand-kit-assistant
contentstack
Advise users on Contentstack Brand Kit concepts, setup, governance, and on-brand AI generation. Route API-specific tasks to the right Brand Kit capability or…
official
cms-assets
contentstack
Advise developers on organizing, delivering, and transforming assets in Contentstack. Cover folder structure, Image Delivery API transformations, publishing…
official
cms-branches-aliases
contentstack
Advise developers on using Contentstack branches for isolated content development and aliases for zero-downtime content deployments. Cover branch strategy,…
official
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…
official
cms-entries
contentstack
Advise developers on querying, localizing, versioning, publishing, and structuring Contentstack entries for efficient delivery. Focus on CDA usage, reference…
official
cms-environments-publishing
contentstack
Advise developers on configuring environments, publishing content, using delivery and preview tokens, leveraging the Sync API, and understanding CDN and…
official
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…
official
cms-localization
contentstack
Advise developers on Contentstack localization: language setup, fallback chains, localized vs unlocalized entries, non-localizable fields, and multi-locale…
official