Skip to content
Back to search

Codex-Skills

Codex-first Agent Skills library for premium frontend, website, motion, accessibility, QA, and handoff workflows.

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/thegoat395--codex-skills/badge.svg)](/listings/thegoat395--codex-skills)

HTML

<a href="/listings/thegoat395--codex-skills"><img src="/api/listings/thegoat395--codex-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.

Get value in under 3 minutes:

git clone https://github.com/TheGoat395/Codex-Skills.git
cd Codex-Skills
python3 scripts/install_skills.py --dry-run
python3 scripts/install_skills.py

Start a new Codex conversation so skill discovery refreshes, then ask:

Use the Codex website skills to review my homepage and tell me the highest-impact improvements before launch.

For a smaller first install:

python3 scripts/install_skills.py --collection taste-and-build-gates

For the newest reviewed skill changes, use the current `main` branch. Published release archives are versioned snapshots and may predate later fixes. To use a specific published snapshot, download it from [GitHub Releases](https://github.com/TheGoat395/Codex-Skills/releases/latest), extract it, then run the same install commands from the extracted folder.

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 · 191 lines

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

  1. # Codex Premium Website Skills
  2. [![Validate Skills](https://github.com/TheGoat395/Codex-Skills/actions/workflows/validate.yml/badge.svg)](https://github.com/TheGoat395/Codex-Skills/actions/workflows/validate.yml)
  3. [![Latest Release](https://img.shields.io/github/v/release/TheGoat395/Codex-Skills?label=release)](https://github.com/TheGoat395/Codex-Skills/releases/latest)
  4. An unofficial, open-source, Codex-first Agent Skills library for premium frontend, website, design-engineering, and reliable agent workflows.
  5. This repository is prepared around a curated `public-core` collection of 80 skills: design direction, frontend implementation, motion, accessibility, QA, content polish, maintainer safety, and agent-quality workflows.
  6. ![Codex Skills modular capabilities visualized](assets/codex_skills_modular_capabilities_visualized.png)
  7. ## Works With
  8. Built for Codex first. Portable to Agent Skills-compatible workflows and adaptable for Claude Code, Cursor, and Gemini CLI.
  9. | Tool | Support Level | Path |
  10. |---|---|---|
  11. | Codex | Native supported | `scripts/install_skills.py` |
  12. | Claude Code | Native-compatible `SKILL.md` folders | `adapters/claude-code/` |
  13. | Cursor | Project rules adapter | `adapters/cursor/` |
  14. | Gemini CLI | Project context adapter | `adapters/gemini-cli/` |
  15. See `COMPATIBILITY.md` for support levels and setup notes.
  16. ## Quick Start
  17. Get value in under 3 minutes:
  18. ```bash
  19. git clone https://github.com/TheGoat395/Codex-Skills.git
  20. cd Codex-Skills
  21. python3 scripts/install_skills.py --dry-run
  22. python3 scripts/install_skills.py
  23. ```
  24. Start a new Codex conversation so skill discovery refreshes, then ask:
  25. ```text
  26. Use the Codex website skills to review my homepage and tell me the highest-impact improvements before launch.
  27. ```
  28. For a smaller first install:
  29. ```bash
  30. python3 scripts/install_skills.py --collection taste-and-build-gates
  31. ```
  32. For the newest reviewed skill changes, use the current `main` branch. Published release archives are versioned snapshots and may predate later fixes. To use a specific published snapshot, download it from [GitHub Releases](https://github.com/TheGoat395/Codex-Skills/releases/latest), extract it, then run the same install commands from the extracted folder.
  33. ## Premium Website Showcase
  34. This repository includes a proof-of-output demo gallery:
  35. ```text
  36. examples/premium-website-showcase/gallery/index.html
  37. ```
  38. The showcase contains nine confirmed local websites and hero/portfolio demos generated through the premium website skill workflow. They are meant to show practical potential: install the skills, provide a prompt/reference/spec, and use the workflow to produce polished local frontend artifacts quickly.
  39. See `DEMOS.md` for the complete list, `EVIDENCE.md` for the current evidence summary, and `INSTALL.md` for local install and preview instructions.
  40. ## Measured Benchmarks
  41. Two paired baseline-vs-skill-assisted runs are checked in with fixed prompts, saved source, explicit limitations, and scoring against `BENCHMARKS.md`.
  42. | Run | Baseline | Skill-assisted | Change | Evidence |
  43. |---|---:|---:|---:|---|
  44. | [Atlas](examples/benchmarks/measured-premium-website-template/runs/2026-07-10-atlas/) | 19/30 | 23/30 | +4 | Source and structural checks |
  45. | [Signal / Matter](examples/benchmarks/measured-premium-website-template/runs/2026-07-10-signal-matter/) | 23/30 | 28/30 | +5 | Desktop/mobile screenshots and automated Chromium QA |
  46. The Signal / Matter run used the same prompt, model, and three-file constraint in isolated directories. Both conditions were capable; the assisted workflow produced stronger visual differentiation, implementation detail, accessible state language, and first-viewport behavior. These are repository rubric scores, not an OpenAI evaluation, endorsement, or universal causal claim.
  47. ## Share Your Work
  48. Used these skills on a real project? [Open a Showcase issue](https://github.com/TheGoat395/Codex-Skills/issues/new?template=showcase.yml) with the skills used, what changed, and any screenshots, links, or workflow notes that would help others evaluate the library.
  49. For stronger evidence, submit a measured benchmark using `examples/benchmarks/measured-premium-website-template/`.
  50. ## What This Is
  51. - A domain-specific Codex skill pack for modern website and app work.
  52. - A Codex-first skill library with adapter paths for Claude Code, Cursor, and Gemini CLI workflows.
  53. - A curated public core, not a loose dump of every local skill.
  54. - A practical toolkit for React, Next.js, Tailwind, GSAP/Motion, QA, copy, accessibility, source research, visual polish, and evidence-led agent work.
  55. - A repo designed to be inspected, installed selectively, benchmarked, and improved in public.
  56. ## What This Is Not
  57. - Not an official OpenAI project.
  58. - Not a guarantee that Codex will produce perfect design or production-ready code without review.
  59. - Not a replacement for project context, real assets, rendered browser inspection, accessibility testing, or engineering judgment.
  60. - Not a reason to install every skill at once. The default install is `public-core`.
  61. - Not a security guarantee. Inspect the repo and installer before running anything.
  62. ## Repository Contents
  63. - `skills/` contains individual Codex skill folders.
  64. - `COMPATIBILITY.md` documents Codex, Claude Code, Cursor, and Gemini CLI usage paths.
  65. - `CATALOG.md` gives a cleaner audience-facing map of collections and high-value skills.
  66. - `adapters/` contains Claude Code, Cursor, and Gemini CLI adapter guidance.
  67. - `curated_collections.json` defines the default 80-skill public core and smaller installable subcollections.
  68. - `scripts/install_skills.py` installs `public-core` by default or selected collections with `--collection`.
  69. - `THIRD_PARTY_NOTICES.md` records license and notice expectations for the public core.
  70. - `EVIDENCE.md`, `BENCHMARKS.md`, `SKILL_QUALITY_STANDARD.md`, and `SECURITY.md` define how this repo should be evaluated and maintained.
  71. - `manifest.json` and `SKILL_INVENTORY.md` are generated inventory files and should be regenerated before a public release.
  72. - `examples/premium-website-showcase/` contains the local proof-of-output gallery and demo preview files.
  73. - `DEMOS.md` documents the confirmed demo set and local preview paths.
  74. - `INSTALL.md` gives a compact install and demo-preview flow.
  75. - `MAINTAINERS.md`, `docs/maintainer-workflow.md`, and `docs/usage-signals.md` document release checks, evidence levels, and public usage signals.
  76. ## Install
  77. Clone the repo, inspect it, then dry-run the default public core:
  78. ```bash
  79. python3 scripts/install_skills.py --dry-run
  80. ```
  81. Install the default 80-skill public core:
  82. ```bash
  83. python3 scripts/install_skills.py
  84. ```
  85. Install a focused collection:
  86. ```bash
  87. python3 scripts/install_skills.py --collection motion-core --dry-run
  88. python3 scripts/install_skills.py --collection motion-core
  89. ```
  90. List available collections:
  91. ```bash
  92. python3 scripts/install_skills.py --list-collections
  93. ```
  94. Replace existing skills only after review:
  95. ```bash
  96. python3 scripts/install_skills.py --replace
  97. ```
  98. The installer uses `$CODEX_HOME/skills` when `CODEX_HOME` is set, otherwise `~/.codex/skills`; an explicit `--dest` takes precedence. It skips existing skills by default. When `--replace` is used, existing skill folders are moved into a timestamped backup folder inside the selected destination.
  99. After installing, start a new Codex conversation so skill discovery refreshes.
  100. ## Public Core Collections
  101. - `public-core`: the full 80-skill public release.
  102. - `taste-and-build-gates`: design direction, build gates, anti-generic review, browser inspection, handoff.
  103. - `visual-direction`: references, art direction, typography, color, layout, imagery.
  104. - `frontend-implementation`: React, Next.js, Tailwind, primitives, states, forms, accessibility.
  105. - `qa-production-core`: accessibility, performance, responsive, cross-browser, visual regression, SEO.
  106. - `motion-core`: motion language, React motion, easing, jank prevention, reduced motion, GSAP performance.
  107. - `content-conversion-core`: copy, IA, CTA language, conversion polish, proof.
  108. - `maintainer-safety-core`: checkpoint, undo/revert, install-safety review.
  109. - `agent-quality-core`: critical and logical thinking, creativity, research, evidence reconciliation, debugging, agent architecture, memory provenance, evaluation, and completion verification.
  110. See `CATALOG.md` for the audience-facing catalog and `CURATED_COLLECTIONS.md` for the full map.
  111. ## Quality Bar
  112. Every skill should have:
  113. - a narrow trigger and clear description
  114. - concrete actions rather than vague taste language
  115. - explicit boundaries for when it should not run
  116. - no hidden network, filesystem, or dependency side effects
  117. - project-local dependency guidance
  118. - verification steps when it changes code, frontend output, or agent workflow state
  119. See `SKILL_QUALITY_STANDARD.md` for contribution criteria.
  120. ## Licensing
  121. The root `LICENSE` covers original repository packaging, docs, scripts, and skills that do not carry separate notices. If a skill folder includes a more specific notice, that notice controls for that folder. See `THIRD_PARTY_NOTICES.md`.
  122. ## Benchmarking
  123. The goal is not to claim that more skills automatically make better output. The goal is to show measurable workflow improvement. Benchmarks should compare the same task with and without selected skill collections, including screenshots, build logs, accessibility checks, browser QA notes, and final code links.
  124. Use `BENCHMARKS.md`, `examples/README.md`, and `examples/benchmarks/measured-premium-website-template/` as the reporting protocol. Atlas is the first source-checked comparison; Signal / Matter adds rendered desktop/mobile evidence and automated Chromium QA. Future runs should preserve the same controls and disclose operator corrections and browser limitations.
  125. ## Open Source Positioning
  126. This project is best described as:
  127. > An open-source Codex skill library for premium frontend, website, design-engineering, and evidence-led agent workflows.
  128. The strongest public contribution is not the size of the library. It is the curation: an installable public core, focused groups, quality standards, safety policy, benchmarks, examples, and real maintenance practices for people building with Codex.

Ratings and comments

Sign in to rate this skill.

Sign in

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