u/Adventurous-Lock-231

I built a small linter for Codex skills/plugins and would like feedback from plugin authors
▲ 0 r/codex

I built a small linter for Codex skills/plugins and would like feedback from plugin authors

I built a small OSS CLI for people creating Codex skills/plugins.

The idea is simple: an ESLint-style publish-readiness check for Codex ecosystem artifacts.

Run it with:

npx codex-skillforge lint .

It checks things like:

  • missing or invalid SKILL.md frontmatter
  • vague skill trigger descriptions
  • broken relative links to scripts/assets/references
  • stale agents/openai.yaml shapes
  • plugin manifest path issues
  • missing bundled skills/hooks/MCP files
  • basic package structure problems before submitting to a marketplace/list

It also includes:

  • init for scaffolding skills/plugins
  • smoke checks for example prompts
  • pack for release artifacts
  • a GitHub Action for CI

Repo: https://github.com/f0d010c/skillforge

Tiny demo repo: https://github.com/f0d010c/codex-skillforge-demo

I’m mainly looking for feedback from people already building Codex skills/plugins:

  • Are these checks useful?
  • What common packaging mistakes should it catch?
  • Would you run something like this in CI before submitting to a marketplace/list?

Not trying to make another marketplace. The goal is just to help people ship cleaner Codex skills/plugins before publishing them.

u/Adventurous-Lock-231 — 5 days ago