# Cyclopts Cli Scripts

> >

- **Type:** Skill
- **Install:** `agentstack add skill-mitodl-agent-kit-cyclopts-cli-scripts`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [mitodl](https://agentstack.voostack.com/s/mitodl)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** BSD-3-Clause
- **Upstream author:** [mitodl](https://github.com/mitodl)
- **Source:** https://github.com/mitodl/agent-kit/tree/main/skills/python/cyclopts-cli-scripts

## Install

```sh
agentstack add skill-mitodl-agent-kit-cyclopts-cli-scripts
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# CLI Scripts with cyclopts

All command-line scripts in this codebase use the **`cyclopts`** framework.

## Framework

Use `cyclopts`, not `argparse`, `click`, `typer`, or bare `sys.argv`.

```python
import cyclopts

app = cyclopts.App()

@app.command
def my_command(arg1: str, flag: bool = False) -> None:
    """Brief description shown in --help."""
    ...

if __name__ == "__main__":
    app()
```

## Location

Place scripts in the `bin/` directory at the root of the relevant project or
repository. Do not place scripts in `src/`, `scripts/`, or ad-hoc locations.

## Naming

Use hyphen-separated names: `bin/migrate-assets`, `bin/sync-catalog`.

## Registering with uv

If the script should be runnable via `uv run `, register it in
`pyproject.toml`:

```toml
[project.scripts]
my-script = "my_package.bin.my_script:app"
```

Or place the script directly in `bin/` and run it with:

```bash
uv run python bin/my-script
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [mitodl](https://github.com/mitodl)
- **Source:** [mitodl/agent-kit](https://github.com/mitodl/agent-kit)
- **License:** BSD-3-Clause

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-mitodl-agent-kit-cyclopts-cli-scripts
- Seller: https://agentstack.voostack.com/s/mitodl
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.