# Agent Skills

Reusable Codex skills and plugins maintained by Surajit Das.

## Install the marketplace

Add this repository as a Codex plugin marketplace:

```bash
codex plugin marketplace add surajit003/agent-skills
```

Restart Codex if the marketplace does not appear immediately. Open the Plugins Directory, select **Surajit's Agent Skills**, and install the plugin you want.

## Available plugins

### Ops Requirements Guidelines

Turns an ambiguous customer brief into grounded operational requirements by separating facts from assumptions, tracing every required datum to a real source, modelling uncertain state explicitly, and defining the smallest useful prototype.

Explicit invocation:

```text
$ops-requirements-guidelines Analyze this client brief and challenge the proposed operating model.
```

[Read the skill documentation](plugins/ops-requirements-guidelines/README.md).

### Readable Python

Guides Codex to design, implement, review, and refactor Python modules using explicit operational flow, descriptive naming, nearby helpers, stateful classes only when needed, and minimal abstraction.

Explicit invocation:

```text
$readable-python Refactor this Python module without changing its behavior.
```

## Repository structure

```text
.agents/plugins/marketplace.json
plugins/
  ops-requirements-guidelines/
    LICENSE
    README.md
    plugin.json
    .codex-plugin/plugin.json
    skills/
      ops-requirements-guidelines/
        SKILL.md
        agents/openai.yaml
        references/worked-example.md
  readable-python/
    plugin.json
    .codex-plugin/plugin.json
    skills/
      readable-python/
        SKILL.md
        agents/openai.yaml
```

## Add another skill

1. Create `plugins/<plugin-name>/skills/<skill-name>/SKILL.md`.
2. Add `.codex-plugin/plugin.json` to the plugin directory.
3. Add the plugin to `.agents/plugins/marketplace.json`.
4. Validate the skill and plugin locally.
5. Commit and push the new version.

Developers who already installed the marketplace can retrieve updates with:

```bash
codex plugin marketplace upgrade surajit003-agent-skills
```

## Licensing

Licensing is declared per plugin. Ops Requirements Guidelines is available under the MIT License; other plugins remain unlicensed unless their directories state otherwise.