character-wizard-cli 0.7.0

Native level-1 SRD character creation CLI
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

# Using Codex in character-wizard

This repository includes durable project guidance and reusable skills for Codex.
Start Codex from the repository root so it discovers both `AGENTS.md` and the
skills under `.agents/skills/`.

## What Codex loads

`AGENTS.md` contains rules that apply to all work in this repository: architecture,
source-of-truth boundaries, coding conventions, and verification commands. Codex
loads it automatically at the start of a session.

Skills contain task-specific workflows. Codex can select a skill when a request
matches its description, or you can explicitly invoke one by typing `$` or using
`/skills` in the CLI or IDE.

## Included skills

| Skill | Use it for |
| --- | --- |
| `$add-srd-content` | Adding or correcting SRD-derived rules and character options |
| `$maintain-pdf-mapping` | Inspecting or changing AcroForm field mappings and PDF output |
| `$verify-pc-wizard` | Running the appropriate tests and full quality gate |
| `$release-pc-wizard` | Selecting, preparing, publishing, and auditing a release |

Example prompts:

```text
Use $add-srd-content to add spell choices for level-1 Wizards from the supplied SRD.

Use $maintain-pdf-mapping to fill the saving-throw proficiency checkboxes.

Use $verify-pc-wizard to validate my current branch and fix any failures.

Use $verify-pc-wizard to rebuild the optimized native executable and run its smoke tests.

Use $release-pc-wizard to suggest the next version and publish the release.
```

## Good task prompts

State the outcome and constraints; Codex can inspect the repository for details.
Useful examples include:

```text
Add point-buy ability generation. Keep the existing standard-array and random modes.

Diagnose why Passive Perception appears in the wrong PDF field. Do not fix it yet.

Add tests for Human size selection and implement the prompt.
```

Mention whether you want diagnosis only, implementation, or a review. Name the
relevant skill when you want Codex to follow that workflow explicitly.

## Verification and troubleshooting

Ask Codex to summarize its active instructions if repository guidance appears not
to load. Restart the Codex session after pulling newly added skills if they do not
appear in `/skills`.

The project quality gate is:

```console
cargo +1.88.0 fmt --check
cargo +1.88.0 clippy --all-targets -- -D warnings
cargo +1.88.0 test --locked
cargo +1.88.0 audit
cargo +1.88.0 deny check
```

Release tooling lives in `Cargo.toml` and `.github/workflows/`. The official
character-sheet PDF is a development fixture only: distributions and releases
must not embed it. At runtime the CLI accepts `--template`, discovers a local or
cached copy, or downloads and validates the supported official sheet. See
[`releasing.md`](releasing.md) for version tags, release recovery, checksums, and
the unsigned-binary policy.

Codex's official documentation explains the discovery and precedence rules for
[`AGENTS.md`](https://developers.openai.com/codex/guides/agents-md) and the
repository locations and invocation behavior for
[skills](https://developers.openai.com/codex/skills).