Metadata-Version: 2.1
Name: codex-skill-kit
Version: 0.1.0
Summary: Scaffold and validate Codex skills from the command line.
Home-page: https://github.com/MukundaKatta/codex-skill-kit
Author: Mukunda Katta
License: MIT
Keywords: codex,openai,skills,cli,developer-tools
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE

# codex-skill-kit

Small command-line tools for building Codex skills.

`codex-skill-kit` helps you scaffold a skill directory and validate the files that make a skill easy for Codex to load, understand, and use.

## Install for development

```bash
python -m pip install -e .
```

## Create a skill

```bash
csk new repo-doctor --description "Inspect repositories for agent-ready project hygiene."
```

This creates:

```text
repo-doctor/
  SKILL.md
  README.md
  examples/
    basic.md
```

## Validate a skill

```bash
csk validate repo-doctor
```

The validator checks for:

- a `SKILL.md` file
- a top-level Markdown heading
- a concise trigger or usage sentence
- a reasonable description length
- references to missing local files
- optional README and examples coverage

## Why this exists

Codex skills are most useful when they are small, clear, and easy to inspect. This package makes that quality bar repeatable, so skill authors can catch rough edges before opening pull requests or sharing skills with a team.



