diff --git a/anygen/agent-harness/skills/anygen_SKILL.md b/anygen/agent-harness/skills/anygen_SKILL.md new file mode 100644 index 000000000..14dd571a5 --- /dev/null +++ b/anygen/agent-harness/skills/anygen_SKILL.md @@ -0,0 +1,174 @@ +--- +name: >- + cli-anything-anygen +description: >- + Command-line interface for Anygen - A stateful command-line interface for AnyGen OpenAPI — generate professional slides, documents, webs... +--- + +# cli-anything-anygen + +A stateful command-line interface for AnyGen OpenAPI — generate professional slides, documents, websites, diagrams, and more from natural language prompts. Designed for AI agents and power users. + +## Installation + +This CLI is installed as part of the cli-anything-anygen package: + +```bash +pip install cli-anything-anygen +``` + +**Prerequisites:** +- Python 3.10+ +- anygen must be installed on your system + + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-anygen --help + +# Start interactive REPL mode +cli-anything-anygen + +# Create a new project +cli-anything-anygen project new -o project.json + +# Run with JSON output (for agent consumption) +cli-anything-anygen --json project info -p project.json +``` + +### REPL Mode + +When invoked without a subcommand, the CLI enters an interactive REPL session: + +```bash +cli-anything-anygen +# Enter commands interactively with tab-completion and history +``` + + +## Command Groups + + +### Task + +Task management — create, poll, download, and run tasks. + +| Command | Description | +|---------|-------------| + + + +### File + +File operations — upload reference files. + +| Command | Description | +|---------|-------------| + + + +### Config + +Configuration management — API key and settings. + +| Command | Description | +|---------|-------------| + +| `config-get` | Get a configuration value (or show all). | + +| `config-delete` | Delete a configuration value. | + +| `config-path` | Show the config file path. | + + + +### Session + +Session management — history, undo, redo. + +| Command | Description | +|---------|-------------| + +| `session-status` | Show session status. | + +| `session-history` | Show command history. | + +| `session-undo` | Undo last command. | + +| `session-redo` | Redo last undone command. | + + + + +## Examples + + +### Create a New Project + +Create a new anygen project file. + +```bash +cli-anything-anygen project new -o myproject.json +# Or with JSON output for programmatic use +cli-anything-anygen --json project new -o myproject.json +``` + + +### Interactive REPL Session + +Start an interactive session with undo/redo support. + +```bash +cli-anything-anygen +# Enter commands interactively +# Use 'help' to see available commands +# Use 'undo' and 'redo' for history navigation +``` + + +## State Management + +The CLI maintains session state with: + +- **Undo/Redo**: Up to 50 levels of history +- **Project persistence**: Save/load project state as JSON +- **Session tracking**: Track modifications and changes + +## Output Formats + +All commands support dual output modes: + +- **Human-readable** (default): Tables, colors, formatted text +- **Machine-readable** (`--json` flag): Structured JSON for agent consumption + +```bash +# Human output +cli-anything-anygen project info -p project.json + +# JSON output for agents +cli-anything-anygen --json project info -p project.json +``` + +## For AI Agents + +When using this CLI programmatically: + +1. **Always use `--json` flag** for parseable output +2. **Check return codes** - 0 for success, non-zero for errors +3. **Parse stderr** for error messages on failure +4. **Use absolute paths** for all file operations +5. **Verify outputs exist** after export operations + +## More Information + +- Full documentation: See README.md in the package +- Test coverage: See TEST.md in the package +- Methodology: See HARNESS.md in the cli-anything-plugin + +## Version + +1.0.0 \ No newline at end of file diff --git a/audacity/agent-harness/skills/audacity_SKILL.md b/audacity/agent-harness/skills/audacity_SKILL.md new file mode 100644 index 000000000..616bc701f --- /dev/null +++ b/audacity/agent-harness/skills/audacity_SKILL.md @@ -0,0 +1,214 @@ +--- +name: >- + cli-anything-audacity +description: >- + Command-line interface for Audacity - A stateful command-line interface for audio editing, following the same patterns as the GIMP and Ble... +--- + +# cli-anything-audacity + +A stateful command-line interface for audio editing, following the same patterns as the GIMP and Blender CLIs in this repo. + +## Installation + +This CLI is installed as part of the cli-anything-audacity package: + +```bash +pip install cli-anything-audacity +``` + +**Prerequisites:** +- Python 3.10+ +- audacity must be installed on your system + + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-audacity --help + +# Start interactive REPL mode +cli-anything-audacity + +# Create a new project +cli-anything-audacity project new -o project.json + +# Run with JSON output (for agent consumption) +cli-anything-audacity --json project info -p project.json +``` + +### REPL Mode + +When invoked without a subcommand, the CLI enters an interactive REPL session: + +```bash +cli-anything-audacity +# Enter commands interactively with tab-completion and history +``` + + +## Command Groups + + +### Project + +Project management commands. + +| Command | Description | +|---------|-------------| + + + +### Track + +Track management commands. + +| Command | Description | +|---------|-------------| + + + +### Clip + +Clip management commands. + +| Command | Description | +|---------|-------------| + + + +### Effect Group + +Effect management commands. + +| Command | Description | +|---------|-------------| + + + +### Selection + +Selection management commands. + +| Command | Description | +|---------|-------------| + + + +### Label + +Label/marker management commands. + +| Command | Description | +|---------|-------------| + + + +### Media + +Media file operations. + +| Command | Description | +|---------|-------------| + + + +### Export Group + +Export/render commands. + +| Command | Description | +|---------|-------------| + + + +### Session Group + +Session management commands. + +| Command | Description | +|---------|-------------| + + + + +## Examples + + +### Create a New Project + +Create a new audacity project file. + +```bash +cli-anything-audacity project new -o myproject.json +# Or with JSON output for programmatic use +cli-anything-audacity --json project new -o myproject.json +``` + + +### Interactive REPL Session + +Start an interactive session with undo/redo support. + +```bash +cli-anything-audacity +# Enter commands interactively +# Use 'help' to see available commands +# Use 'undo' and 'redo' for history navigation +``` + + +### Export Project + +Export the project to a final output format. + +```bash +cli-anything-audacity --project myproject.json export render output.pdf --overwrite +``` + + +## State Management + +The CLI maintains session state with: + +- **Undo/Redo**: Up to 50 levels of history +- **Project persistence**: Save/load project state as JSON +- **Session tracking**: Track modifications and changes + +## Output Formats + +All commands support dual output modes: + +- **Human-readable** (default): Tables, colors, formatted text +- **Machine-readable** (`--json` flag): Structured JSON for agent consumption + +```bash +# Human output +cli-anything-audacity project info -p project.json + +# JSON output for agents +cli-anything-audacity --json project info -p project.json +``` + +## For AI Agents + +When using this CLI programmatically: + +1. **Always use `--json` flag** for parseable output +2. **Check return codes** - 0 for success, non-zero for errors +3. **Parse stderr** for error messages on failure +4. **Use absolute paths** for all file operations +5. **Verify outputs exist** after export operations + +## More Information + +- Full documentation: See README.md in the package +- Test coverage: See TEST.md in the package +- Methodology: See HARNESS.md in the cli-anything-plugin + +## Version + +1.0.0 \ No newline at end of file diff --git a/blender/agent-harness/skills/blender_SKILL.md b/blender/agent-harness/skills/blender_SKILL.md new file mode 100644 index 000000000..615ecf756 --- /dev/null +++ b/blender/agent-harness/skills/blender_SKILL.md @@ -0,0 +1,205 @@ +--- +name: >- + cli-anything-blender +description: >- + Command-line interface for Blender - A stateful command-line interface for 3D scene editing, following the same patterns as the GIMP CLI ... +--- + +# cli-anything-blender + +A stateful command-line interface for 3D scene editing, following the same patterns as the GIMP CLI harness. Uses a JSON scene description format with bpy script generation for actual Blender rendering. + +## Installation + +This CLI is installed as part of the cli-anything-blender package: + +```bash +pip install cli-anything-blender +``` + +**Prerequisites:** +- Python 3.10+ +- blender must be installed on your system + + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-blender --help + +# Start interactive REPL mode +cli-anything-blender + +# Create a new project +cli-anything-blender project new -o project.json + +# Run with JSON output (for agent consumption) +cli-anything-blender --json project info -p project.json +``` + +### REPL Mode + +When invoked without a subcommand, the CLI enters an interactive REPL session: + +```bash +cli-anything-blender +# Enter commands interactively with tab-completion and history +``` + + +## Command Groups + + +### Scene + +Scene management commands. + +| Command | Description | +|---------|-------------| + + + +### Object Group + +3D object management commands. + +| Command | Description | +|---------|-------------| + + + +### Material + +Material management commands. + +| Command | Description | +|---------|-------------| + + + +### Modifier Group + +Modifier management commands. + +| Command | Description | +|---------|-------------| + + + +### Camera + +Camera management commands. + +| Command | Description | +|---------|-------------| + + + +### Light + +Light management commands. + +| Command | Description | +|---------|-------------| + + + +### Animation + +Animation and keyframe commands. + +| Command | Description | +|---------|-------------| + + + +### Render Group + +Render settings and output commands. + +| Command | Description | +|---------|-------------| + + + +### Session + +Session management commands. + +| Command | Description | +|---------|-------------| + + + + +## Examples + + +### Create a New Project + +Create a new blender project file. + +```bash +cli-anything-blender project new -o myproject.json +# Or with JSON output for programmatic use +cli-anything-blender --json project new -o myproject.json +``` + + +### Interactive REPL Session + +Start an interactive session with undo/redo support. + +```bash +cli-anything-blender +# Enter commands interactively +# Use 'help' to see available commands +# Use 'undo' and 'redo' for history navigation +``` + + +## State Management + +The CLI maintains session state with: + +- **Undo/Redo**: Up to 50 levels of history +- **Project persistence**: Save/load project state as JSON +- **Session tracking**: Track modifications and changes + +## Output Formats + +All commands support dual output modes: + +- **Human-readable** (default): Tables, colors, formatted text +- **Machine-readable** (`--json` flag): Structured JSON for agent consumption + +```bash +# Human output +cli-anything-blender project info -p project.json + +# JSON output for agents +cli-anything-blender --json project info -p project.json +``` + +## For AI Agents + +When using this CLI programmatically: + +1. **Always use `--json` flag** for parseable output +2. **Check return codes** - 0 for success, non-zero for errors +3. **Parse stderr** for error messages on failure +4. **Use absolute paths** for all file operations +5. **Verify outputs exist** after export operations + +## More Information + +- Full documentation: See README.md in the package +- Test coverage: See TEST.md in the package +- Methodology: See HARNESS.md in the cli-anything-plugin + +## Version + +1.0.0 \ No newline at end of file diff --git a/cli-anything-plugin/HARNESS.md b/cli-anything-plugin/HARNESS.md index 64c2b20e3..9de518b81 100644 --- a/cli-anything-plugin/HARNESS.md +++ b/cli-anything-plugin/HARNESS.md @@ -74,8 +74,8 @@ designed for humans, without needing a display or mouse. ```python from cli_anything..utils.repl_skin import ReplSkin - skin = ReplSkin("", version="1.0.0") - skin.print_banner() # Branded startup box + skin = ReplSkin("", version="1.0.0", skill_path="skills/_SKILL.md") + skin.print_banner() # Branded startup box (includes skill path for agents) pt_session = skin.create_prompt_session() # prompt_toolkit with history + styling line = skin.get_input(pt_session, project_name="my_project", modified=True) skin.help(commands_dict) # Formatted help listing @@ -88,6 +88,8 @@ designed for humans, without needing a display or mouse. skin.progress(3, 10, "...") # Progress bar skin.print_goodbye() # Styled exit message ``` + - **Important**: Include `skill_path` parameter to display the SKILL.md location in the + banner. This allows AI agents to discover where to read the skill documentation. - Make REPL the default behavior: use `invoke_without_command=True` on the main Click group, and invoke the `repl` command when no subcommand is given: ```python @@ -304,6 +306,23 @@ skill definition. - List all command groups with brief descriptions - Provide realistic examples that demonstrate common workflows +**Display Skill Path in CLI Banner:** + +After generating SKILL.md, update the CLI's REPL initialization to display the skill +path in the startup banner. This helps AI agents discover where to read the skill +documentation when using the CLI: + +```python +# In the REPL initialization (e.g., shotcut_cli.py) +from cli_anything..utils.repl_skin import ReplSkin + +skin = ReplSkin("", version="1.0.0", skill_path="skills/_SKILL.md") +skin.print_banner() # Now displays: ◇ Skill: skills/_SKILL.md +``` + +This enables agents to know exactly where to find the skill definition when they +encounter the CLI. + ## Critical Lessons Learned ### Use the Real Software — Don't Reimplement It diff --git a/cli-anything-plugin/repl_skin.py b/cli-anything-plugin/repl_skin.py index 47260bebd..c279b581d 100644 --- a/cli-anything-plugin/repl_skin.py +++ b/cli-anything-plugin/repl_skin.py @@ -6,7 +6,7 @@ Copy this file into your CLI package at: Usage: from cli_anything..utils.repl_skin import ReplSkin - skin = ReplSkin("shotcut", version="1.0.0") + skin = ReplSkin("shotcut", version="1.0.0", skill_path="skills/shotcut_SKILL.md") skin.print_banner() prompt_text = skin.prompt(project_name="my_video.mlt", modified=True) skin.success("Project saved") @@ -97,7 +97,7 @@ class ReplSkin: """ def __init__(self, software: str, version: str = "1.0.0", - history_file: str | None = None): + history_file: str | None = None, skill_path: str | None = None): """Initialize the REPL skin. Args: @@ -105,10 +105,13 @@ class ReplSkin: version: CLI version string. history_file: Path for persistent command history. Defaults to ~/.cli-anything-/history + skill_path: Path to the SKILL.md file for agent discovery. + Displayed in banner for AI agents to know where to read skill info. """ self.software = software.lower().replace("-", "_") self.display_name = software.replace("_", " ").title() self.version = version + self.skill_path = skill_path self.accent = _ACCENT_COLORS.get(self.software, _DEFAULT_ACCENT) # History file @@ -165,9 +168,19 @@ class ReplSkin: tip = f" {self._c(_DARK_GRAY, ' Type help for commands, quit to exit')}" empty = "" + # Skill path for agent discovery + skill_line = None + if self.skill_path: + skill_icon = self._c(_MAGENTA, "◇") + skill_label = self._c(_DARK_GRAY, " Skill:") + skill_path_display = self._c(_LIGHT_GRAY, self.skill_path) + skill_line = f" {skill_icon} {skill_label} {skill_path_display}" + print(top) print(_box_line(title)) print(_box_line(ver)) + if skill_line: + print(_box_line(skill_line)) print(_box_line(empty)) print(_box_line(tip)) print(bot) diff --git a/cli-anything-plugin/skill_generator.py b/cli-anything-plugin/skill_generator.py index ccf047ac0..115da5027 100644 --- a/cli-anything-plugin/skill_generator.py +++ b/cli-anything-plugin/skill_generator.py @@ -77,7 +77,7 @@ def extract_cli_metadata(harness_path: str) -> SkillMetadata: f"cli_anything directory not found in {harness_path}. " "Ensure the harness structure includes cli_anything//" ) - software_dirs = [d for d in cli_anything_dir.iterdir()] + software_dirs = [d for d in cli_anything_dir.iterdir() if d.is_dir() and (d / "__init__.py").exists()] if not software_dirs: diff --git a/drawio/agent-harness/skills/drawio_SKILL.md b/drawio/agent-harness/skills/drawio_SKILL.md new file mode 100644 index 000000000..27df05ad3 --- /dev/null +++ b/drawio/agent-harness/skills/drawio_SKILL.md @@ -0,0 +1,187 @@ +--- +name: >- + cli-anything-drawio +description: >- + Command-line interface for Drawio - A CLI harness for **Draw.io** — create, edit, and export diagrams from the command line.... +--- + +# cli-anything-drawio + +A CLI harness for **Draw.io** — create, edit, and export diagrams from the command line. + +## Installation + +This CLI is installed as part of the cli-anything-drawio package: + +```bash +pip install cli-anything-drawio +``` + +**Prerequisites:** +- Python 3.10+ +- drawio must be installed on your system + + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-drawio --help + +# Start interactive REPL mode +cli-anything-drawio + +# Create a new project +cli-anything-drawio project new -o project.json + +# Run with JSON output (for agent consumption) +cli-anything-drawio --json project info -p project.json +``` + +### REPL Mode + +When invoked without a subcommand, the CLI enters an interactive REPL session: + +```bash +cli-anything-drawio +# Enter commands interactively with tab-completion and history +``` + + +## Command Groups + + +### Project + +Project management: new, open, save, info. + +| Command | Description | +|---------|-------------| + + + +### Shape + +Shape operations: add, remove, move, resize, style. + +| Command | Description | +|---------|-------------| + + + +### Connect + +Connector operations: add, remove, style. + +| Command | Description | +|---------|-------------| + + + +### Page + +Page operations: add, remove, rename, list. + +| Command | Description | +|---------|-------------| + + + +### Export + +Export operations: render to PNG, PDF, SVG. + +| Command | Description | +|---------|-------------| + + + +### Session + +Session management: status, undo, redo. + +| Command | Description | +|---------|-------------| + + + + +## Examples + + +### Create a New Project + +Create a new drawio project file. + +```bash +cli-anything-drawio project new -o myproject.json +# Or with JSON output for programmatic use +cli-anything-drawio --json project new -o myproject.json +``` + + +### Interactive REPL Session + +Start an interactive session with undo/redo support. + +```bash +cli-anything-drawio +# Enter commands interactively +# Use 'help' to see available commands +# Use 'undo' and 'redo' for history navigation +``` + + +### Export Project + +Export the project to a final output format. + +```bash +cli-anything-drawio --project myproject.json export render output.pdf --overwrite +``` + + +## State Management + +The CLI maintains session state with: + +- **Undo/Redo**: Up to 50 levels of history +- **Project persistence**: Save/load project state as JSON +- **Session tracking**: Track modifications and changes + +## Output Formats + +All commands support dual output modes: + +- **Human-readable** (default): Tables, colors, formatted text +- **Machine-readable** (`--json` flag): Structured JSON for agent consumption + +```bash +# Human output +cli-anything-drawio project info -p project.json + +# JSON output for agents +cli-anything-drawio --json project info -p project.json +``` + +## For AI Agents + +When using this CLI programmatically: + +1. **Always use `--json` flag** for parseable output +2. **Check return codes** - 0 for success, non-zero for errors +3. **Parse stderr** for error messages on failure +4. **Use absolute paths** for all file operations +5. **Verify outputs exist** after export operations + +## More Information + +- Full documentation: See README.md in the package +- Test coverage: See TEST.md in the package +- Methodology: See HARNESS.md in the cli-anything-plugin + +## Version + +1.0.0 \ No newline at end of file diff --git a/gimp/agent-harness/skills/gimp_SKILL.md b/gimp/agent-harness/skills/gimp_SKILL.md new file mode 100644 index 000000000..fd616ba24 --- /dev/null +++ b/gimp/agent-harness/skills/gimp_SKILL.md @@ -0,0 +1,205 @@ +--- +name: >- + cli-anything-gimp +description: >- + Command-line interface for Gimp - A stateful command-line interface for image editing, built on Pillow. Designed for AI agents and pow... +--- + +# cli-anything-gimp + +A stateful command-line interface for image editing, built on Pillow. Designed for AI agents and power users who need to create and manipulate images without a GUI. + +## Installation + +This CLI is installed as part of the cli-anything-gimp package: + +```bash +pip install cli-anything-gimp +``` + +**Prerequisites:** +- Python 3.10+ +- gimp must be installed on your system + + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-gimp --help + +# Start interactive REPL mode +cli-anything-gimp + +# Create a new project +cli-anything-gimp project new -o project.json + +# Run with JSON output (for agent consumption) +cli-anything-gimp --json project info -p project.json +``` + +### REPL Mode + +When invoked without a subcommand, the CLI enters an interactive REPL session: + +```bash +cli-anything-gimp +# Enter commands interactively with tab-completion and history +``` + + +## Command Groups + + +### Project + +Project management commands. + +| Command | Description | +|---------|-------------| + + + +### Layer + +Layer management commands. + +| Command | Description | +|---------|-------------| + + + +### Canvas + +Canvas operations. + +| Command | Description | +|---------|-------------| + + + +### Filter Group + +Filter management commands. + +| Command | Description | +|---------|-------------| + + + +### Media + +Media file operations. + +| Command | Description | +|---------|-------------| + + + +### Export Group + +Export/render commands. + +| Command | Description | +|---------|-------------| + + + +### Session + +Session management commands. + +| Command | Description | +|---------|-------------| + + + +### Draw + +Drawing operations (applied at render time). + +| Command | Description | +|---------|-------------| + + + + +## Examples + + +### Create a New Project + +Create a new gimp project file. + +```bash +cli-anything-gimp project new -o myproject.json +# Or with JSON output for programmatic use +cli-anything-gimp --json project new -o myproject.json +``` + + +### Interactive REPL Session + +Start an interactive session with undo/redo support. + +```bash +cli-anything-gimp +# Enter commands interactively +# Use 'help' to see available commands +# Use 'undo' and 'redo' for history navigation +``` + + +### Export Project + +Export the project to a final output format. + +```bash +cli-anything-gimp --project myproject.json export render output.pdf --overwrite +``` + + +## State Management + +The CLI maintains session state with: + +- **Undo/Redo**: Up to 50 levels of history +- **Project persistence**: Save/load project state as JSON +- **Session tracking**: Track modifications and changes + +## Output Formats + +All commands support dual output modes: + +- **Human-readable** (default): Tables, colors, formatted text +- **Machine-readable** (`--json` flag): Structured JSON for agent consumption + +```bash +# Human output +cli-anything-gimp project info -p project.json + +# JSON output for agents +cli-anything-gimp --json project info -p project.json +``` + +## For AI Agents + +When using this CLI programmatically: + +1. **Always use `--json` flag** for parseable output +2. **Check return codes** - 0 for success, non-zero for errors +3. **Parse stderr** for error messages on failure +4. **Use absolute paths** for all file operations +5. **Verify outputs exist** after export operations + +## More Information + +- Full documentation: See README.md in the package +- Test coverage: See TEST.md in the package +- Methodology: See HARNESS.md in the cli-anything-plugin + +## Version + +1.0.0 \ No newline at end of file diff --git a/inkscape/agent-harness/skills/inkscape_SKILL.md b/inkscape/agent-harness/skills/inkscape_SKILL.md new file mode 100644 index 000000000..346e20c17 --- /dev/null +++ b/inkscape/agent-harness/skills/inkscape_SKILL.md @@ -0,0 +1,223 @@ +--- +name: >- + cli-anything-inkscape +description: >- + Command-line interface for Inkscape - A stateful command-line interface for vector graphics editing, following the same patterns as the GI... +--- + +# cli-anything-inkscape + +A stateful command-line interface for vector graphics editing, following the same patterns as the GIMP and Blender CLI harnesses. Directly manipulates SVG (XML) documents with a JSON project format for state tracking. + +## Installation + +This CLI is installed as part of the cli-anything-inkscape package: + +```bash +pip install cli-anything-inkscape +``` + +**Prerequisites:** +- Python 3.10+ +- inkscape must be installed on your system + + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-inkscape --help + +# Start interactive REPL mode +cli-anything-inkscape + +# Create a new project +cli-anything-inkscape project new -o project.json + +# Run with JSON output (for agent consumption) +cli-anything-inkscape --json project info -p project.json +``` + +### REPL Mode + +When invoked without a subcommand, the CLI enters an interactive REPL session: + +```bash +cli-anything-inkscape +# Enter commands interactively with tab-completion and history +``` + + +## Command Groups + + +### Document + +Document management commands. + +| Command | Description | +|---------|-------------| + + + +### Shape + +Shape management commands. + +| Command | Description | +|---------|-------------| + + + +### Text + +Text management commands. + +| Command | Description | +|---------|-------------| + + + +### Style + +Style management commands. + +| Command | Description | +|---------|-------------| + + + +### Transform + +Transform operations (translate, rotate, scale, skew). + +| Command | Description | +|---------|-------------| + + + +### Layer + +Layer management commands. + +| Command | Description | +|---------|-------------| + + + +### Path Group + +Path boolean operations. + +| Command | Description | +|---------|-------------| + + + +### Gradient + +Gradient management commands. + +| Command | Description | +|---------|-------------| + + + +### Export Group + +Export/render commands. + +| Command | Description | +|---------|-------------| + + + +### Session + +Session management commands. + +| Command | Description | +|---------|-------------| + + + + +## Examples + + +### Create a New Project + +Create a new inkscape project file. + +```bash +cli-anything-inkscape project new -o myproject.json +# Or with JSON output for programmatic use +cli-anything-inkscape --json project new -o myproject.json +``` + + +### Interactive REPL Session + +Start an interactive session with undo/redo support. + +```bash +cli-anything-inkscape +# Enter commands interactively +# Use 'help' to see available commands +# Use 'undo' and 'redo' for history navigation +``` + + +### Export Project + +Export the project to a final output format. + +```bash +cli-anything-inkscape --project myproject.json export render output.pdf --overwrite +``` + + +## State Management + +The CLI maintains session state with: + +- **Undo/Redo**: Up to 50 levels of history +- **Project persistence**: Save/load project state as JSON +- **Session tracking**: Track modifications and changes + +## Output Formats + +All commands support dual output modes: + +- **Human-readable** (default): Tables, colors, formatted text +- **Machine-readable** (`--json` flag): Structured JSON for agent consumption + +```bash +# Human output +cli-anything-inkscape project info -p project.json + +# JSON output for agents +cli-anything-inkscape --json project info -p project.json +``` + +## For AI Agents + +When using this CLI programmatically: + +1. **Always use `--json` flag** for parseable output +2. **Check return codes** - 0 for success, non-zero for errors +3. **Parse stderr** for error messages on failure +4. **Use absolute paths** for all file operations +5. **Verify outputs exist** after export operations + +## More Information + +- Full documentation: See README.md in the package +- Test coverage: See TEST.md in the package +- Methodology: See HARNESS.md in the cli-anything-plugin + +## Version + +1.0.0 \ No newline at end of file diff --git a/kdenlive/agent-harness/skills/kdenlive_SKILL.md b/kdenlive/agent-harness/skills/kdenlive_SKILL.md new file mode 100644 index 000000000..3ad48da72 --- /dev/null +++ b/kdenlive/agent-harness/skills/kdenlive_SKILL.md @@ -0,0 +1,205 @@ +--- +name: >- + cli-anything-kdenlive +description: >- + Command-line interface for Kdenlive - A stateful command-line interface for video editing, following the same patterns as the Blender CLI ... +--- + +# cli-anything-kdenlive + +A stateful command-line interface for video editing, following the same patterns as the Blender CLI harness. Uses a JSON project format with MLT XML generation for Kdenlive/melt. + +## Installation + +This CLI is installed as part of the cli-anything-kdenlive package: + +```bash +pip install cli-anything-kdenlive +``` + +**Prerequisites:** +- Python 3.10+ +- kdenlive must be installed on your system + + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-kdenlive --help + +# Start interactive REPL mode +cli-anything-kdenlive + +# Create a new project +cli-anything-kdenlive project new -o project.json + +# Run with JSON output (for agent consumption) +cli-anything-kdenlive --json project info -p project.json +``` + +### REPL Mode + +When invoked without a subcommand, the CLI enters an interactive REPL session: + +```bash +cli-anything-kdenlive +# Enter commands interactively with tab-completion and history +``` + + +## Command Groups + + +### Project + +Project management commands. + +| Command | Description | +|---------|-------------| + + + +### Bin Group + +Media bin management commands. + +| Command | Description | +|---------|-------------| + + + +### Timeline + +Timeline management commands. + +| Command | Description | +|---------|-------------| + + + +### Filter Group + +Filter/effect management commands. + +| Command | Description | +|---------|-------------| + + + +### Transition + +Transition management commands. + +| Command | Description | +|---------|-------------| + + + +### Guide + +Guide/marker management commands. + +| Command | Description | +|---------|-------------| + + + +### Export + +Export and render commands. + +| Command | Description | +|---------|-------------| + + + +### Session + +Session management commands. + +| Command | Description | +|---------|-------------| + + + + +## Examples + + +### Create a New Project + +Create a new kdenlive project file. + +```bash +cli-anything-kdenlive project new -o myproject.json +# Or with JSON output for programmatic use +cli-anything-kdenlive --json project new -o myproject.json +``` + + +### Interactive REPL Session + +Start an interactive session with undo/redo support. + +```bash +cli-anything-kdenlive +# Enter commands interactively +# Use 'help' to see available commands +# Use 'undo' and 'redo' for history navigation +``` + + +### Export Project + +Export the project to a final output format. + +```bash +cli-anything-kdenlive --project myproject.json export render output.pdf --overwrite +``` + + +## State Management + +The CLI maintains session state with: + +- **Undo/Redo**: Up to 50 levels of history +- **Project persistence**: Save/load project state as JSON +- **Session tracking**: Track modifications and changes + +## Output Formats + +All commands support dual output modes: + +- **Human-readable** (default): Tables, colors, formatted text +- **Machine-readable** (`--json` flag): Structured JSON for agent consumption + +```bash +# Human output +cli-anything-kdenlive project info -p project.json + +# JSON output for agents +cli-anything-kdenlive --json project info -p project.json +``` + +## For AI Agents + +When using this CLI programmatically: + +1. **Always use `--json` flag** for parseable output +2. **Check return codes** - 0 for success, non-zero for errors +3. **Parse stderr** for error messages on failure +4. **Use absolute paths** for all file operations +5. **Verify outputs exist** after export operations + +## More Information + +- Full documentation: See README.md in the package +- Test coverage: See TEST.md in the package +- Methodology: See HARNESS.md in the cli-anything-plugin + +## Version + +1.0.0 \ No newline at end of file diff --git a/libreoffice/agent-harness/skills/libreoffice_SKILL.md b/libreoffice/agent-harness/skills/libreoffice_SKILL.md new file mode 100644 index 000000000..a2d357c70 --- /dev/null +++ b/libreoffice/agent-harness/skills/libreoffice_SKILL.md @@ -0,0 +1,196 @@ +--- +name: >- + cli-anything-libreoffice +description: >- + Command-line interface for Libreoffice - A stateful command-line interface for document editing, producing real ODF files (ZIP archives with ... +--- + +# cli-anything-libreoffice + +A stateful command-line interface for document editing, producing real ODF files (ZIP archives with XML). Designed for AI agents and power users who need to create and manipulate Writer, Calc, and Impress documents without a GUI or LibreOffice installation. + +## Installation + +This CLI is installed as part of the cli-anything-libreoffice package: + +```bash +pip install cli-anything-libreoffice +``` + +**Prerequisites:** +- Python 3.10+ +- libreoffice must be installed on your system + + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-libreoffice --help + +# Start interactive REPL mode +cli-anything-libreoffice + +# Create a new project +cli-anything-libreoffice project new -o project.json + +# Run with JSON output (for agent consumption) +cli-anything-libreoffice --json project info -p project.json +``` + +### REPL Mode + +When invoked without a subcommand, the CLI enters an interactive REPL session: + +```bash +cli-anything-libreoffice +# Enter commands interactively with tab-completion and history +``` + + +## Command Groups + + +### Document + +Document management commands. + +| Command | Description | +|---------|-------------| + + + +### Writer + +Writer (word processor) commands. + +| Command | Description | +|---------|-------------| + + + +### Calc + +Calc (spreadsheet) commands. + +| Command | Description | +|---------|-------------| + + + +### Impress + +Impress (presentation) commands. + +| Command | Description | +|---------|-------------| + + + +### Style Group + +Style management commands. + +| Command | Description | +|---------|-------------| + + + +### Export Group + +Export/render commands. + +| Command | Description | +|---------|-------------| + + + +### Session + +Session management commands. + +| Command | Description | +|---------|-------------| + + + + +## Examples + + +### Create a New Project + +Create a new libreoffice project file. + +```bash +cli-anything-libreoffice project new -o myproject.json +# Or with JSON output for programmatic use +cli-anything-libreoffice --json project new -o myproject.json +``` + + +### Interactive REPL Session + +Start an interactive session with undo/redo support. + +```bash +cli-anything-libreoffice +# Enter commands interactively +# Use 'help' to see available commands +# Use 'undo' and 'redo' for history navigation +``` + + +### Export Project + +Export the project to a final output format. + +```bash +cli-anything-libreoffice --project myproject.json export render output.pdf --overwrite +``` + + +## State Management + +The CLI maintains session state with: + +- **Undo/Redo**: Up to 50 levels of history +- **Project persistence**: Save/load project state as JSON +- **Session tracking**: Track modifications and changes + +## Output Formats + +All commands support dual output modes: + +- **Human-readable** (default): Tables, colors, formatted text +- **Machine-readable** (`--json` flag): Structured JSON for agent consumption + +```bash +# Human output +cli-anything-libreoffice project info -p project.json + +# JSON output for agents +cli-anything-libreoffice --json project info -p project.json +``` + +## For AI Agents + +When using this CLI programmatically: + +1. **Always use `--json` flag** for parseable output +2. **Check return codes** - 0 for success, non-zero for errors +3. **Parse stderr** for error messages on failure +4. **Use absolute paths** for all file operations +5. **Verify outputs exist** after export operations + +## More Information + +- Full documentation: See README.md in the package +- Test coverage: See TEST.md in the package +- Methodology: See HARNESS.md in the cli-anything-plugin + +## Version + +1.0.0 \ No newline at end of file diff --git a/obs-studio/agent-harness/skills/obs_studio_SKILL.md b/obs-studio/agent-harness/skills/obs_studio_SKILL.md new file mode 100644 index 000000000..55c31500a --- /dev/null +++ b/obs-studio/agent-harness/skills/obs_studio_SKILL.md @@ -0,0 +1,196 @@ +--- +name: >- + cli-anything-obs_studio +description: >- + Command-line interface for Obs Studio - A stateful command-line interface for OBS Studio scene collection editing, following the same patter... +--- + +# cli-anything-obs_studio + +A stateful command-line interface for OBS Studio scene collection editing, following the same patterns as the Blender CLI harness. Uses a JSON scene collection format. No OBS installation required for editing. + +## Installation + +This CLI is installed as part of the cli-anything-obs_studio package: + +```bash +pip install cli-anything-obs_studio +``` + +**Prerequisites:** +- Python 3.10+ +- obs_studio must be installed on your system + + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-obs_studio --help + +# Start interactive REPL mode +cli-anything-obs_studio + +# Create a new project +cli-anything-obs_studio project new -o project.json + +# Run with JSON output (for agent consumption) +cli-anything-obs_studio --json project info -p project.json +``` + +### REPL Mode + +When invoked without a subcommand, the CLI enters an interactive REPL session: + +```bash +cli-anything-obs_studio +# Enter commands interactively with tab-completion and history +``` + + +## Command Groups + + +### Project + +Project management commands. + +| Command | Description | +|---------|-------------| + + + +### Scene Group + +Scene management commands. + +| Command | Description | +|---------|-------------| + + + +### Source Group + +Source management commands. + +| Command | Description | +|---------|-------------| + + + +### Filter Group + +Filter management commands. + +| Command | Description | +|---------|-------------| + + + +### Audio Group + +Audio management commands. + +| Command | Description | +|---------|-------------| + + + +### Transition Group + +Transition management commands. + +| Command | Description | +|---------|-------------| + + + +### Output Group + +Output/streaming/recording configuration. + +| Command | Description | +|---------|-------------| + + + +### Session + +Session management commands. + +| Command | Description | +|---------|-------------| + + + + +## Examples + + +### Create a New Project + +Create a new obs_studio project file. + +```bash +cli-anything-obs_studio project new -o myproject.json +# Or with JSON output for programmatic use +cli-anything-obs_studio --json project new -o myproject.json +``` + + +### Interactive REPL Session + +Start an interactive session with undo/redo support. + +```bash +cli-anything-obs_studio +# Enter commands interactively +# Use 'help' to see available commands +# Use 'undo' and 'redo' for history navigation +``` + + +## State Management + +The CLI maintains session state with: + +- **Undo/Redo**: Up to 50 levels of history +- **Project persistence**: Save/load project state as JSON +- **Session tracking**: Track modifications and changes + +## Output Formats + +All commands support dual output modes: + +- **Human-readable** (default): Tables, colors, formatted text +- **Machine-readable** (`--json` flag): Structured JSON for agent consumption + +```bash +# Human output +cli-anything-obs_studio project info -p project.json + +# JSON output for agents +cli-anything-obs_studio --json project info -p project.json +``` + +## For AI Agents + +When using this CLI programmatically: + +1. **Always use `--json` flag** for parseable output +2. **Check return codes** - 0 for success, non-zero for errors +3. **Parse stderr** for error messages on failure +4. **Use absolute paths** for all file operations +5. **Verify outputs exist** after export operations + +## More Information + +- Full documentation: See README.md in the package +- Test coverage: See TEST.md in the package +- Methodology: See HARNESS.md in the cli-anything-plugin + +## Version + +1.0.0 \ No newline at end of file diff --git a/shotcut/agent-harness/skills/shotcut_SKILL.md b/shotcut/agent-harness/skills/shotcut_SKILL.md new file mode 100644 index 000000000..e6cfa5222 --- /dev/null +++ b/shotcut/agent-harness/skills/shotcut_SKILL.md @@ -0,0 +1,205 @@ +--- +name: >- + cli-anything-shotcut +description: >- + Command-line interface for Shotcut - A stateful command-line interface for video editing, built on the MLT XML format. Designed for AI ag... +--- + +# cli-anything-shotcut + +A stateful command-line interface for video editing, built on the MLT XML format. Designed for AI agents and power users who need to create and edit Shotcut projects without a GUI. + +## Installation + +This CLI is installed as part of the cli-anything-shotcut package: + +```bash +pip install cli-anything-shotcut +``` + +**Prerequisites:** +- Python 3.10+ +- shotcut must be installed on your system + + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-shotcut --help + +# Start interactive REPL mode +cli-anything-shotcut + +# Create a new project +cli-anything-shotcut project new -o project.json + +# Run with JSON output (for agent consumption) +cli-anything-shotcut --json project info -p project.json +``` + +### REPL Mode + +When invoked without a subcommand, the CLI enters an interactive REPL session: + +```bash +cli-anything-shotcut +# Enter commands interactively with tab-completion and history +``` + + +## Command Groups + + +### Project + +Project management: new, open, save, info. + +| Command | Description | +|---------|-------------| + + + +### Timeline + +Timeline operations: tracks, clips, trimming. + +| Command | Description | +|---------|-------------| + + + +### Filter Group + +Filter operations: add, remove, configure effects. + +| Command | Description | +|---------|-------------| + + + +### Media + +Media operations: probe, list, check files. + +| Command | Description | +|---------|-------------| + + + +### Export + +Export/render operations. + +| Command | Description | +|---------|-------------| + + + +### Transition Group + +Transition operations: dissolve, wipe, and other transitions. + +| Command | Description | +|---------|-------------| + + + +### Composite Group + +Compositing: blend modes, PIP, opacity. + +| Command | Description | +|---------|-------------| + + + +### Session + +Session management: status, undo, redo. + +| Command | Description | +|---------|-------------| + + + + +## Examples + + +### Create a New Project + +Create a new shotcut project file. + +```bash +cli-anything-shotcut project new -o myproject.json +# Or with JSON output for programmatic use +cli-anything-shotcut --json project new -o myproject.json +``` + + +### Interactive REPL Session + +Start an interactive session with undo/redo support. + +```bash +cli-anything-shotcut +# Enter commands interactively +# Use 'help' to see available commands +# Use 'undo' and 'redo' for history navigation +``` + + +### Export Project + +Export the project to a final output format. + +```bash +cli-anything-shotcut --project myproject.json export render output.pdf --overwrite +``` + + +## State Management + +The CLI maintains session state with: + +- **Undo/Redo**: Up to 50 levels of history +- **Project persistence**: Save/load project state as JSON +- **Session tracking**: Track modifications and changes + +## Output Formats + +All commands support dual output modes: + +- **Human-readable** (default): Tables, colors, formatted text +- **Machine-readable** (`--json` flag): Structured JSON for agent consumption + +```bash +# Human output +cli-anything-shotcut project info -p project.json + +# JSON output for agents +cli-anything-shotcut --json project info -p project.json +``` + +## For AI Agents + +When using this CLI programmatically: + +1. **Always use `--json` flag** for parseable output +2. **Check return codes** - 0 for success, non-zero for errors +3. **Parse stderr** for error messages on failure +4. **Use absolute paths** for all file operations +5. **Verify outputs exist** after export operations + +## More Information + +- Full documentation: See README.md in the package +- Test coverage: See TEST.md in the package +- Methodology: See HARNESS.md in the cli-anything-plugin + +## Version + +1.0.0 \ No newline at end of file diff --git a/zoom/agent-harness/skills/zoom_SKILL.md b/zoom/agent-harness/skills/zoom_SKILL.md new file mode 100644 index 000000000..f70e38021 --- /dev/null +++ b/zoom/agent-harness/skills/zoom_SKILL.md @@ -0,0 +1,160 @@ +--- +name: >- + cli-anything-zoom +description: >- + Command-line interface for Zoom - CLI harness for **Zoom** — manage meetings, participants, and recordings from the command line via t... +--- + +# cli-anything-zoom + +CLI harness for **Zoom** — manage meetings, participants, and recordings from the command line via the Zoom REST API. + +## Installation + +This CLI is installed as part of the cli-anything-zoom package: + +```bash +pip install cli-anything-zoom +``` + +**Prerequisites:** +- Python 3.10+ +- zoom must be installed on your system + + +## Usage + +### Basic Commands + +```bash +# Show help +cli-anything-zoom --help + +# Start interactive REPL mode +cli-anything-zoom + +# Create a new project +cli-anything-zoom project new -o project.json + +# Run with JSON output (for agent consumption) +cli-anything-zoom --json project info -p project.json +``` + +### REPL Mode + +When invoked without a subcommand, the CLI enters an interactive REPL session: + +```bash +cli-anything-zoom +# Enter commands interactively with tab-completion and history +``` + + +## Command Groups + + +### Auth + +Authentication and OAuth2 setup. + +| Command | Description | +|---------|-------------| + + + +### Meeting + +Meeting management commands. + +| Command | Description | +|---------|-------------| + + + +### Participant + +Participant management commands. + +| Command | Description | +|---------|-------------| + + + +### Recording + +Cloud recording management. + +| Command | Description | +|---------|-------------| + + + + +## Examples + + +### Create a New Project + +Create a new zoom project file. + +```bash +cli-anything-zoom project new -o myproject.json +# Or with JSON output for programmatic use +cli-anything-zoom --json project new -o myproject.json +``` + + +### Interactive REPL Session + +Start an interactive session with undo/redo support. + +```bash +cli-anything-zoom +# Enter commands interactively +# Use 'help' to see available commands +# Use 'undo' and 'redo' for history navigation +``` + + +## State Management + +The CLI maintains session state with: + +- **Undo/Redo**: Up to 50 levels of history +- **Project persistence**: Save/load project state as JSON +- **Session tracking**: Track modifications and changes + +## Output Formats + +All commands support dual output modes: + +- **Human-readable** (default): Tables, colors, formatted text +- **Machine-readable** (`--json` flag): Structured JSON for agent consumption + +```bash +# Human output +cli-anything-zoom project info -p project.json + +# JSON output for agents +cli-anything-zoom --json project info -p project.json +``` + +## For AI Agents + +When using this CLI programmatically: + +1. **Always use `--json` flag** for parseable output +2. **Check return codes** - 0 for success, non-zero for errors +3. **Parse stderr** for error messages on failure +4. **Use absolute paths** for all file operations +5. **Verify outputs exist** after export operations + +## More Information + +- Full documentation: See README.md in the package +- Test coverage: See TEST.md in the package +- Methodology: See HARNESS.md in the cli-anything-plugin + +## Version + +1.0.0 \ No newline at end of file