# Add CLI Options

> This skill covers the creation of shared options for CLI commands. Trigger: When defining command-line interfaces using the `click` library.

- Skill: `jnzader/add-cli-options` (Agent Skill)
- Install (CLI): `npx skillmds@latest add jnzader/add-cli-options`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jnzader/add-cli-options/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: Apache-2.0
- Author: JNZader (https://skillmd.com/u/jnzader)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/jnzader/add-cli-options

---


## Critical Patterns

### Define Main Command

Use the `main` function to set up the entry point for your CLI application.

```python
import click
from repoforge.cli import main

@main.command()
def my_command():
    click.echo("This is my command.")
```

### Add Skills

Utilize the `skills` export to define reusable command options.

```python
import click
from repoforge.cli import skills

@skills.option('--verbose', is_flag=True, help='Enable verbose output.')
def my_command(verbose):
    if verbose:
        click.echo("Verbose mode is on.")
```

## When to Use

- When creating a new command for the CLI.
- To add common options across multiple commands.
- To streamline the execution of default commands.

## Commands

```bash
python repoforge/cli.py my_command
```

## Anti-Patterns

### Don't: Hardcode Options

Hardcoding options reduces flexibility and reusability across commands.

```python
# BAD
@click.command()
@click.option('--option', default='value', help='Hardcoded option.')
def my_command(option):
    click.echo(option)
```

## Quick Reference

| Task                | Pattern                |
|---------------------|------------------------|
| Define a command    | `@main.command()`      |
| Add shared options   | `@skills.option()`     |