Metadata-Version: 2.4
Name: cli-creator-skill
Version: 0.1.1
Summary: Installable cli-creator agent skill for designing and auditing Python CLI tools.
Project-URL: Homepage, https://github.com/AdvancingTitans/cli-creator-skill
Project-URL: Repository, https://github.com/AdvancingTitans/cli-creator-skill
Project-URL: Issues, https://github.com/AdvancingTitans/cli-creator-skill/issues
Author: yjw
License-Expression: MIT
License-File: LICENSE
License-File: NOTICE.md
Keywords: agent-skill,cli,codex,llm,questionary,rich,typer
Classifier: Development Status :: 3 - Alpha
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
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# cli-creator

`cli-creator` is a reusable agent skill for designing, building, and auditing high-quality Python CLI tools.

It is especially useful for Typer + Rich + questionary projects with interactive flows, data fetching, caching, LLM provider setup, structured output, local profile memory, and multi-channel delivery.

## Install As A Codex Skill

Clone this repository and copy the skill directory into your Codex skills folder:

```bash
git clone https://github.com/AdvancingTitans/cli-creator-skill.git
mkdir -p ~/.codex/skills
cp -R cli-creator-skill/skills/cli-creator ~/.codex/skills/cli-creator
```

Then ask your agent to use `cli-creator` when creating or reviewing CLI tools.

## Install From PyPI

```bash
pip install cli-creator-skill
cli-creator-skill install
```

By default this installs the skill to `~/.codex/skills/cli-creator`.

Install to a custom directory:

```bash
cli-creator-skill install --target ~/.agents/skills
```

## Release

Maintainers can publish a new version by updating `pyproject.toml`, committing the change, and pushing a version tag:

```bash
git tag v0.1.1
git push origin v0.1.1
```

## What This Skill Helps With

- Design a new Python CLI from scratch.
- Review an existing CLI for UX, packaging, errors, model setup, caching, and maintainability.
- Structure Typer + Rich + questionary applications.
- Build natural multi-turn CLI flows without making users feel like they are filling out a form.
- Add robust model provider configuration for OpenAI, Anthropic, Ark/OpenAI-compatible endpoints, and local models.
- Add cache, profile memory, diagnostics, and first-run setup flows.

## Repository Structure

```text
cli-creator-skill/
  skills/cli-creator/
    SKILL.md
    references/
      creation-playbook.md
      pitfalls-and-solutions.md
      review-rubric.md
  src/cli_creator_skill/
    installer.py
    __main__.py
  pyproject.toml
  README.md
  LICENSE
```

## Usage

Use this skill when you ask:

- "帮我从零设计一个 Python CLI"
- "帮我审查这个 Typer CLI"
- "这个 CLI 的交互很别扭，帮我重构"
- "帮我设计模型配置、缓存、doctor、profile memory"
- "帮我发布一个可 pip install 的 CLI"

## Sources And Design Influences

This skill distills practical lessons from building interactive Python CLIs and from studying mature CLI projects and documentation patterns, including:

- [larksuite/cli](https://github.com/larksuite/cli)
- [soongenwong/claudecode](https://github.com/soongenwong/claudecode)
- [Astral uv](https://github.com/astral-sh/uv)
- [Astral ruff](https://github.com/astral-sh/ruff)
- Typer, Rich, questionary, Pydantic, litellm, and instructor project practices

## License

MIT
