Skip to content
Back to search

agent-skills

Reusable agent skills for Codex and compatible tools

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/golbin--agent-skills/badge.svg)](/listings/golbin--agent-skills)

HTML

<a href="/listings/golbin--agent-skills"><img src="/api/listings/golbin--agent-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

skills.sh / `npx skills`

Install globally for Codex and Claude Code:

npx skills add https://github.com/golbin/agent-skills/tree/main/skills/prd \
  -g \
  -a codex claude-code \
  -y
npx skills add https://github.com/golbin/agent-skills/tree/main/skills/review \
  -g \
  -a codex claude-code \
  -y

Or install from the repository and select a skill:

npx skills add golbin/agent-skills --skill prd -g -a codex claude-code -y
npx skills add golbin/agent-skills --skill review -g -a codex claude-code -y

List available skills in this repository:

npx skills add golbin/agent-skills --list

GitHub CLI `gh skill`

Requires GitHub CLI 2.90.0 or newer.

gh skill install golbin/agent-skills prd --agent codex --scope user
gh skill install golbin/agent-skills review --agent codex --scope user

The alias form also works on supported GitHub CLI versions:

gh skills add golbin/agent-skills prd --agent codex --scope user
gh skills add golbin/agent-skills review --agent codex --scope user

Preview before installing:

gh skill preview golbin/agent-skills prd
gh skill preview golbin/agent-skills review

Codex Skill Installer

In Codex, ask:

Use $skill-installer to install https://github.com/golbin/agent-skills/tree/main/skills/prd
Use $skill-installer to install https://github.com/golbin/agent-skills/tree/main/skills/review

Or run the installer script directly:

python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
  --repo golbin/agent-skills \
  --path skills/prd
python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
  --repo golbin/agent-skills \
  --path skills/review

Updated skills are available on the next Codex turn. Reload Claude Code if its current session still shows an older copy.

Shell Installer

For machines with `bash`, `curl`, and `tar`:

curl -fsSL https://raw.githubusercontent.com/golbin/agent-skills/main/install.sh | bash
curl -fsSL https://raw.githubusercontent.com/golbin/agent-skills/main/install.sh \
  | SKILL_PATH=skills/review SKILL_NAME=review bash

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 157 lines · 1 finding marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Agent Skills
  2. Reusable agent skills for Codex and other Agent Skills compatible tools.
  3. Skills are packaged under `skills/<skill-name>/` so this repository can hold
  4. multiple installable skills.
  5. ## Repository Layout
  6. - `skills/`: installable agent skills discovered by `npx skills` and `gh skill`
  7. - `templates/`: copyable project templates such as `AGENTS.md` and `CLAUDE.md`
  8. ## Available Skills
  9. - `prd`: Design the simplest user-centered solution, then refine its living
  10. implementation checklist as evidence changes.
  11. - `review`: Review designs and implementations with user experience first,
  12. favor simple Unix-style composition and easy removal, and fix issues when requested.
  13. ## Templates
  14. - `templates/AGENTS.md`: concise project instruction template for coding agents
  15. - `templates/CLAUDE.md`: delegates Claude-compatible tools to `AGENTS.md`
  16. Copy the templates into a project root and customize the placeholders:
  17. ```bash
  18. cp templates/AGENTS.md /path/to/project/AGENTS.md
  19. cp templates/CLAUDE.md /path/to/project/CLAUDE.md
  20. ```
  21. ## Install
  22. ### skills.sh / `npx skills`
  23. Install globally for Codex and Claude Code:
  24. ```bash
  25. npx skills add https://github.com/golbin/agent-skills/tree/main/skills/prd \
  26. -g \
  27. -a codex claude-code \
  28. -y
  29. npx skills add https://github.com/golbin/agent-skills/tree/main/skills/review \
  30. -g \
  31. -a codex claude-code \
  32. -y
  33. ```
  34. Or install from the repository and select a skill:
  35. ```bash
  36. npx skills add golbin/agent-skills --skill prd -g -a codex claude-code -y
  37. npx skills add golbin/agent-skills --skill review -g -a codex claude-code -y
  38. ```
  39. List available skills in this repository:
  40. ```bash
  41. npx skills add golbin/agent-skills --list
  42. ```
  43. ### GitHub CLI `gh skill`
  44. Requires GitHub CLI 2.90.0 or newer.
  45. ```bash
  46. gh skill install golbin/agent-skills prd --agent codex --scope user
  47. gh skill install golbin/agent-skills review --agent codex --scope user
  48. ```
  49. The alias form also works on supported GitHub CLI versions:
  50. ```bash
  51. gh skills add golbin/agent-skills prd --agent codex --scope user
  52. gh skills add golbin/agent-skills review --agent codex --scope user
  53. ```
  54. Preview before installing:
  55. ```bash
  56. gh skill preview golbin/agent-skills prd
  57. gh skill preview golbin/agent-skills review
  58. ```
  59. ### Codex Skill Installer
  60. In Codex, ask:
  61. ```text
  62. Use $skill-installer to install https://github.com/golbin/agent-skills/tree/main/skills/prd
  63. Use $skill-installer to install https://github.com/golbin/agent-skills/tree/main/skills/review
  64. ```
  65. Or run the installer script directly:
  66. ```bash
  67. python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
  68. --repo golbin/agent-skills \
  69. --path skills/prd
  70. python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
  71. --repo golbin/agent-skills \
  72. --path skills/review
  73. ```
  74. Updated skills are available on the next Codex turn. Reload Claude Code if its
  75. current session still shows an older copy.
  76. ### Shell Installer
  77. For machines with `bash`, `curl`, and `tar`:
  78. ```bash
  79. curl -fsSL https://raw.githubusercontent.com/golbin/agent-skills/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 113 on GitHub
  80. curl -fsSL https://raw.githubusercontent.com/golbin/agent-skills/main/install.sh \
  81. | SKILL_PATH=skills/review SKILL_NAME=review bash
  82. ```
  83. ## Usage
  84. Invoke skills in Codex by name, for example:
  85. ```text
  86. Use $prd to design the simplest user-centered solution and an evolving implementation checklist.
  87. Use $review to review this design against its requirements and user workflow.
  88. Use $review to review this implementation for user experience, simplicity, and maintainability.
  89. Use $review to fix the confirmed issues and verify the result.
  90. ```
  91. The `prd` skill keeps the user's task, purpose, target design, and an evolving
  92. implementation checklist in one concise living document. The
  93. `review` skill assesses designs and implementations from the perspective of
  94. end users, developers, and operators. It favors simplicity, focused composable
  95. parts, and easy removal, and fixes root causes when improvements are requested.
  96. Planning and review respect the task scope; they do not introduce a new approval
  97. step when implementation is already authorized.
  98. ## Updating
  99. Reinstall the selected skills to update both clients and their source metadata:
  100. ```bash
  101. npx skills add golbin/agent-skills --skill prd review \
  102. -g -a codex claude-code -y
  103. ```
  104. `review` replaces the former `review-implementation` skill. After installing it,
  105. archive the old installation (preserving local edits) so only the new name is
  106. available.
  107. Before replacing an installation, preserve any local edits. If an old standalone
  108. copy exists under `~/.codex/skills/`, compare it with the shared installation at
  109. `~/.agents/skills/` and archive the stale copy so Codex sees one version.
  110. The repository commit and the installer lock record identify the installed
  111. revision. These skills follow the focused descriptions and proportional guidance
  112. in [Rethinking skills and prompts for GPT-6 Astra](https://developers.openai.com/blog/rethinking-skills-and-prompts-for-gpt-6-astra),
  113. while remaining usable by other agents.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.