# Codex Skills Collection

This repository is a curated collection of Codex skills referenced in the
AI tools for developers training talks. It keeps the skills in one ordinary git
repository so they can be reviewed, installed, edited, and used as examples of
how skills package reusable agent workflows.

## Installation

Run the setup script to symlink each skill directory into your Codex skills
folder:

```bash
./setup-skills.sh
```

By default, skills are linked into `$HOME/.codex/skills`. To install somewhere
else:

```bash
CODEX_SKILLS_DIR=/path/to/skills ./setup-skills.sh
```

To preview what would be linked:

```bash
./setup-skills.sh --dry-run
```

The installer discovers every top-level directory that contains a `SKILL.md`
file.

## Included Skills

### Local / Custom Skills

- `gitea-issues` - work with self-hosted Gitea repositories, issues, pull
  requests, and issue dependency workflows.
- `grill-me` - interview a user about a plan or design until the decision tree
  is resolved.
- `shared-abstraction-refactor` - find duplicated local patterns and promote
  obvious shared abstractions.

### Copied Or Adapted From Other Repositories

- `c4-diff` - copied from Jo Van Eyck's skills repository:
  https://github.com/jovaneyck/skills
- `grill-with-docs` - copied from Matt Pocock's skills repository:
  https://github.com/mattpocock/skills
- `to-spec` - copied from Matt Pocock's skills repository:
  https://github.com/mattpocock/skills
- `to-tickets` - copied from Matt Pocock's skills repository:
  https://github.com/mattpocock/skills
- `wayfinder` - copied from Matt Pocock's skills repository:
  https://github.com/mattpocock/skills

## Attribution

Thanks to Matt Pocock for the engineering planning skills in
https://github.com/mattpocock/skills, including `wayfinder`, `grill-with-docs`,
`to-spec`, and `to-tickets`.

Thanks to Jo Van Eyck for the `c4-diff` skill in
https://github.com/jovaneyck/skills.

The copied upstream skills remain credited to their original authors. This repo
packages them together with local skills so they can be installed and used as a
single training-oriented Codex skills collection.

## Scope

This repo intentionally includes only the skills referenced in the training
talks. Other personal skills may exist elsewhere, but they are left out here so
the examples match the material from the presentations.

## License

This repository is licensed under the MIT License. See [LICENSE](./LICENSE).