# Conscrypt Formatting

> Conscrypt Formatting is an Agent Skill for development published in the google/conscrypt repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Automatically formats C++, Java, and C source files in the Conscrypt directory using a project-specific formatting tool. Use when you have modified any C++, Java, or C files under `third_party/java/conscrypt/main_src/` and need to ensure they comply with project style before committing or submitting. Don't use for general Google3 formatting (use the standard `g4 fix` or `hg fix` instead unless working in Conscrypt).

- Skill name: `conscrypt-formatting`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/google/conscrypt/blob/HEAD/skills/conscrypt_formatting/SKILL.md
- Repository: google/conscrypt (1,398 GitHub stars when collected)

## SKILL.md

# Conscrypt Formatting

When modifying C++, C, or Java files in the Conscrypt project, you **MUST** run
the project's custom formatting script. The standard `g4 fix` or global
formatters are not sufficient as Conscrypt uses a specific configuration.

## Critical Rules

1.  **Run after modifications**: Always run the formatter *after* making any
    changes to `.java`, `.cc`, `.h`, `.cpp`, or `.c` files in Conscrypt, and
    *before* creating a CL, uploading, or submitting.
2.  **Files must be opened**: The formatting script only processes files that
    are currently **opened for edit** in your VCS (e.g., via `g4 edit`, `hg
    edit`, etc.). Ensure your modified files are opened before running the
    script.

## How to Format

Run the Python script located in the Conscrypt root directory:

```bash
python3 third_party/java/conscrypt/main_src/fix_format.py
```

---

Source: https://www.openparable.com/skill/development/conscrypt-formatting (OpenParable). Cite the canonical URL above.
