Skills Learning
This repository is a workspace for creating, improving, and testing Codex/OpenAI-style skills.
The repo currently includes a local seo-reviewer skill and supporting files. The .agents/ directory may contain installed or cached skills used during local development, but it is ignored by Git and should be treated as local machine state.
Repository Layout
.
├── skills/
│ └── seo-reviewer/
│ ├── LICENSE
│ ├── SKILL.md
│ ├── evals/
│ │ └── evals.json
│ ├── references/
│ │ └── audit-checklist.md
│ └── scripts/
│ └── seo_snapshot.py
├── LICENSE
├── skills-lock.json
└── README.md
What Is a Skill?
A skill is a folder that teaches Codex how to perform a specialized workflow. Each skill must include a SKILL.md file with YAML frontmatter:
---
name: seo-reviewer
description: Review websites, landing pages, web apps, and source code for SEO...
---
The description controls when the skill is triggered. The body of SKILL.md explains how Codex should perform the task.
Optional folders:
references/: deeper documentation loaded only when needed.
evals/: test prompts and expectations for validating skill behavior.
scripts/: reusable scripts for deterministic or repetitive work.
assets/: templates, images, or other files used by the skill.
Included Skill
seo-reviewer
Use this skill when you want Codex to audit websites, landing pages, web apps, or source code for SEO issues.
Example prompts:
Use the seo-reviewer skill to audit https://example.com for technical SEO and metadata issues.
Review this Next.js app for SEO before launch. Focus on metadata, sitemap, robots, structured data, and rendering issues.
Audit this product page HTML for ecommerce SEO and AI search readiness.
The skill is located at:
skills/seo-reviewer/SKILL.md
Its deeper checklist is in:
skills/seo-reviewer/references/audit-checklist.md
Its test prompts are in:
skills/seo-reviewer/evals/evals.json
It also includes a small standard-library helper script for extracting a basic SEO evidence snapshot from a URL or HTML file:
python3 skills/seo-reviewer/scripts/seo_snapshot.py https://example.com
python3 skills/seo-reviewer/scripts/seo_snapshot.py ./page.html
Using