Publish training skills collection

2026-08-12 16:59:21 -04:00
commit bbfeac41de
24 changed files with 2041 additions and 0 deletions
@@ -0,0 +1,78 @@
+# 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).