gitwtfhub

wtf is skills-learning?

bilalkhan4086/skills-learning — explained in plain English

Analysis updated 2026-05-18

12PythonAudience · developerComplexity · 2/5LicenseSetup · easy

TL;DR

A workspace of reusable 'skill' folders that teach OpenAI's Codex how to do specialized tasks, including a working SEO audit skill.

Mindmap

mindmap
  root((Skills Learning))
    What it does
      Build Codex skills
      Test skill behavior
      SEO audit skill
    Tech stack
      Python
      SKILL.md format
      Codex
    Use cases
      Audit websites for SEO
      Create new skills
      Validate skill files
    Audience
      Developers
      AI tool builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Audit a website, landing page, or web app for SEO issues like missing metadata, broken sitemaps, or structured data problems.

REASON 2

Create a new Codex skill by writing a SKILL.md file with a name, trigger description, and instructions.

REASON 3

Validate a skill's files and run its evals.json test prompts to check behavior across changes.

REASON 4

Pull a basic SEO evidence snapshot from a URL or local HTML file using the included Python script.

What's in the stack?

PythonCodexYAML

How it stacks up

bilalkhan4086/skills-learningaim-uofa/reasonmatchairbone42/360-data-athlete
Stars121212
LanguagePythonPythonPython
Setup difficultyeasyhardhard
Complexity2/55/54/5
Audiencedeveloperresearchergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Needs Python 3 and a Codex environment that can load skills from the skills/ folder.

MIT license: use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

Wtf does this do

Skills Learning is a workspace for building and testing "skills" for Codex, OpenAI's coding assistant. A skill is a folder of instructions that teaches Codex how to carry out a specialized task, so instead of typing out detailed instructions every time, you can just reference the skill and Codex knows what to do. Each skill has a required file called SKILL.md, which starts with a short block describing the skill's name and a description that tells Codex when to use it, followed by the actual instructions for the task. A skill can also include optional folders: references for deeper documentation that only loads when needed, evals for test prompts that check whether the skill behaves correctly, scripts for small reusable programs the skill can call on, and assets for templates or other supporting files. This repository currently ships one working example skill called seo-reviewer, which audits websites, landing pages, web apps, or source code for search engine optimization problems, such as missing metadata, broken sitemaps, or structured data issues. It comes with its own checklist document, a set of test prompts, and a small Python script that pulls a basic SEO snapshot from a web page or an HTML file. To use a skill, you simply reference it by name or path in a prompt to Codex, or describe the task naturally and let Codex pick the right skill on its own if it recognizes the request. The repository also explains how to create a brand new skill from scratch, how to validate that a skill's files are well formed, and how to run its test prompts to compare behavior across changes. A separate lock file keeps track of any external skills that were installed from other sources, along with hashes to verify their origin. The project is released under the MIT license, and its included seo-reviewer skill carries its own copy of that license as well.

Yoink these prompts

Prompt 1
Use the seo-reviewer skill in this repo to audit my landing page for technical SEO and metadata issues.
Prompt 2
Help me write a new SKILL.md for a skill that reviews pull requests for accessibility problems.
Prompt 3
Run skills/seo-reviewer/scripts/seo_snapshot.py against my site and explain the output.
Prompt 4
Show me how to validate that my new skill folder in skills/ is structured correctly.

Frequently asked questions

wtf is skills-learning?

A workspace of reusable 'skill' folders that teach OpenAI's Codex how to do specialized tasks, including a working SEO audit skill.

What language is skills-learning written in?

Mainly Python. The stack also includes Python, Codex, YAML.

What license does skills-learning use?

MIT license: use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

How hard is skills-learning to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is skills-learning for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.