# Python Formatting

> Python formatting skill for Black, isort, and IDE configuration. Trigger phrases: format Python, Black config, code style, isort imports, linting, format on save, PEP 8.

- **Type:** Skill
- **Install:** `agentstack add skill-caraya-agent-skills-python-formatting`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [caraya](https://agentstack.voostack.com/s/caraya)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [caraya](https://github.com/caraya)
- **Source:** https://github.com/caraya/agent-skills/tree/main/skills/python-formatting

## Install

```sh
agentstack add skill-caraya-agent-skills-python-formatting
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Python Formatting

## Use When

- Setting up or validating code formatting for Python projects.
- Configuring Black and isort for consistent style.
- Integrating formatting into IDE or pre-commit hooks.

## Standard Formatters

1. **Black** (recommended for Python)
- Opinionated, minimal configuration, fast.
- Enforces PEP 8 with specific style choices (88-char line width).
- Install: `pip install black`.

2. **isort** (import sorting)
- Organizes imports into sections (stdlib, third-party, local).
- Integrates with Black.
- Install: `pip install isort`.

3. **Ruff** (optional, fast linter and formatter)
- Modern, Rust-based; superset of some Black functionality.
- Can format and lint in one pass.
- Install: `pip install ruff`.

## Configuration

### `pyproject.toml` (Black and isort):
```toml
[tool.black]
line-length = 88
target-version = ['py39', 'py310', 'py311']

[tool.isort]
profile = "black"
line_length = 88
skip_glob = [".venv", "venv"]
```

### `.flake8` or `pyproject.toml` (linting):
```toml
[tool.flake8]
max-line-length = 88
exclude = [".venv", "venv", ".git"]
```

### VS Code `.vscode/settings.json`:
```json
{
  "[python]": {
    "editor.formatOnSave": true,
    "editor.defaultFormatter": "ms-python.python",
    "editor.codeActionsOnSave": {
      "source.organizeImports": true
    }
  },
  "python.formatting.provider": "black",
  "python.linting.enabled": true,
  "python.linting.flake8Enabled": true
}
```

## Checklist

1. Consistency
- Black is installed and configured via `pyproject.toml`.
- isort is configured with `profile = "black"` to avoid conflicts.
- Configuration is version-controlled and shared with team.

2. IDE integration
- Format-on-save is enabled in VS Code.
- Python extension is installed and active.

3. Pre-commit hooks
- Use `pre-commit` framework with Black and isort hooks.
- Prevents unformatted code from entering the repository.

4. Import organization
- isort sorts imports into stdlib, third-party, local sections.
- Multi-line imports are handled consistently.

## Formatting Rules

- Line width: 88 characters (Black standard).
- Indentation: 4 spaces (PEP 8).
- String quotes: Double quotes (customizable, Black default).
- Trailing commas: Used for multi-line structures.
- Import order: Stdlib, third-party, local (isort).

## Common Commands

- Format: `black src/`.
- Sort imports: `isort src/`.
- Check: `black --check src/` or `isort --check src/`.
- Combined: `black src/ && isort src/`.

## Output Requirements

When setting up or validating formatting, provide:
- Formatter versions and configuration.
- IDE integration status.
- Pre-commit hook setup summary.
- Any conflicts or inconsistencies found.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [caraya](https://github.com/caraya)
- **Source:** [caraya/agent-skills](https://github.com/caraya/agent-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-caraya-agent-skills-python-formatting
- Seller: https://agentstack.voostack.com/s/caraya
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.