Debate Helper

---

version: "2.0.0"

name: Debate Helper

description: "Build debate arguments and plan rebuttals with structured evidence. Use when constructing arguments, preparing rebuttals, structuring outlines."

author: BytesAgain

homepage: https://bytesagain.com

source: https://github.com/bytesagain/ai-skills

---

# Debate Helper

Multi-purpose utility tool for managing data entries, configuring settings, searching records, and exporting information. Provides a simple command-line interface for adding, listing, removing, and searching items in a local data store with full history logging.

Commands

| Command | Description |

|---------|-------------|

| `debate-helper run <args>` | Execute the main function with the provided arguments. Logs the operation to history. |

| `debate-helper config <args>` | Show or manage configuration. Displays the config file path (`config.json` in the data directory). |

| `debate-helper status <args>` | Show current status of the tool (reports "ready" when operational). |

| `debate-helper init <args>` | Initialize the data directory and prepare the tool for first use. |

| `debate-helper list <args>` | List all entries currently stored in the data log. Shows "(empty)" if no data exists. |

| `debate-helper add <text>` | Add a new entry to the data log. Each entry is prefixed with the current date (YYYY-MM-DD). |

| `debate-helper remove <item>` | Remove an entry from the data log by identifier. |

| `debate-helper search <term>` | Search the data log for entries matching the given term (case-insensitive). |

| `debate-helper export <args>` | Export all data from the data log to stdout. Shows "No data" if the log is empty. |

| `debate-helper info <args>` | Show tool version and data directory path. |

| `debate-helper help` | Display all available commands and usage information. |

| `debate-helper version` | Show the current version (v2.0.0). |

Data Storage

All data is stored in the directory specified by `$DEBATE_HELPER_DIR` (defaults to `~/.local/share/debate-helper/`):

Requirements

When to Use

1. **Quick note-taking and idea capture** — Use `add` to jot down ideas, arguments, or observations with automatic date-stamping for easy retrieval later.

2. **Managing a simple knowledge base** — Use `add`, `list`, `search`, and `remove` to maintain a lightweight, searchable collection of entries without needing a database.

3. **Project initialization and setup** — Use `init` and `config` to set up the data directory and verify configuration before starting a new workflow.

4. **Searching and exporting records** — Use `search` to find specific entries by keyword and `export` to dump all data for use in other tools or pipelines.

5. **Batch processing in automation pipelines** — Use `run` to execute operations programmatically and `status` to verify the tool is ready before chaining commands in scripts.

Examples

Initialize and add entries

debate-helper init
debate-helper add "Universal basic income improves economic resilience"
debate-helper add "Counter: UBI may reduce workforce participation"
debate-helper add "Evidence: Finland 2017-2018 UBI trial showed improved wellbeing"
debate-helper list

Search and manage entries

debate-helper search "UBI"
debate-helper search "evidence"
debate-helper remove "outdated-entry"
debate-helper list

Check status and export

debate-helper status
debate-helper info
debate-helper export
debate-helper export > debate_notes.txt

Configuration and execution

debate-helper config
debate-helper run "analyze arguments for immigration policy debate"
debate-helper version

---

*Powered by BytesAgain | bytesagain.com | hello@bytesagain.com*