add-cli-options

name	add-cli-options
description	This skill covers the creation of shared options for CLI commands. Trigger: When defining command-line interfaces using the `click` library.
license	Apache-2.0
metadata	{"author":"repoforge","version":"1.0"}

Critical Patterns

Define Main Command

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

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.

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

python repoforge/cli.py my_command

Anti-Patterns

Don't: Hardcode Options

Hardcoding options reduces flexibility and reusability across commands.

# 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()