Skip to main content

Skills

A skill is a package of structured files that teaches an AI coding agent how to work with a specific tool or framework. The skill below was generated by Great Docs from this project’s documentation. Install it in your agent and it will be able to run commands, edit configuration, write content, and troubleshoot problems without step-by-step guidance from you.

Any agent — install with npx:

npx skills add https://mkennedy.codes/docs/gilguard/

Codex / OpenCode

Tell the agent:
Fetch the skill file at https://mkennedy.codes/docs/gilguard/skill.md and follow the instructions.

Manual — download the skill file:

curl -O https://mkennedy.codes/docs/gilguard/skill.md

Or browse the SKILL.md file.

SKILL.md

---
name: gilguard
description: >
  Raise a detailed error the moment an import re-enables the GIL on free-threaded Python. Use when writing Python code that uses the gilguard package.
license: MIT
compatibility: Requires Python >=3.13.
---

# gilguard

Raise a detailed error the moment an import re-enables the GIL on free-threaded Python.

## Installation

```bash
pip install gilguard
```

## API overview

### When the GIL comes back on

What gilguard raises or warns with, and the report that comes with it.

- `GILEnabledError`
- `GILReport`
- `GILGuardWarning`

### Turning the guard on and off

`import gilguard` calls install() for you. Use these to choose the action in code or to stop guarding.

- `install`
- `uninstall`

### Checking the interpreter

Small helpers you can use with or without the guard installed.

- `is_free_threaded_build`
- `gil_enabled`

## Resources

- [Full documentation](https://mkennedy.codes/docs/gilguard/)
- [llms.txt](llms.txt) — Indexed API reference for LLMs
- [llms-full.txt](llms-full.txt) — Comprehensive documentation for LLMs
- [Source code](https://github.com/mikeckennedy/gilguard)