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://posit-dev.github.io/py-yaml12/

Works with Claude Code, GitHub Copilot, Cursor, Gemini CLI, Codex, and 30+ other agents.

Codex / OpenCode — tell the agent:

Fetch the skill file at https://posit-dev.github.io/py-yaml12/skill.md and follow the instructions.

Manual — download the skill file:

curl -O https://posit-dev.github.io/py-yaml12/skill.md

Or browse the SKILL.md file.

SKILL.md

---
name: yaml12
description: >
  A modern YAML 1.2 parser and emitter for Python, written in Rust. Use when writing Python code that uses the yaml12 package.
license: MIT
compatibility: Requires Python >=3.10.
---

# yaml12

A modern YAML 1.2 parser and emitter for Python, written in Rust.

## Installation

```bash
pip install yaml12
```

## API overview

### Classes

Wrapper types for tagged nodes and unhashable mapping keys

- `Yaml`: Tagged node or hashable wrapper for unhashable mapping keys

### Functions

Public functions for parsing and emitting YAML

- `parse_yaml`: Parse YAML text into Python values
- `read_yaml`: Read a YAML file from `path` and parse it
- `format_yaml`: Serialize a Python value to a YAML string
- `write_yaml`: Write a Python value to YAML at `path` or stdout

## Resources

- [Full documentation](https://posit-dev.github.io/py-yaml12/)
- [llms.txt](llms.txt) — Indexed API reference for LLMs
- [llms-full.txt](llms-full.txt) — Comprehensive documentation for LLMs
- [Source code](https://github.com/posit-dev/py-yaml12)