WW

wwa-cli-runner

Provides a direct interface for executing WriteWithAI (wwa) CLI commands.

Install

mkdir -p .claude/skills/wwa-cli-runner && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/18444" && unzip -o skill.zip -d .claude/skills/wwa-cli-runner && rm skill.zip

Installs to .claude/skills/wwa-cli-runner

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Direct CLI runner for WriteWithAI. When the user types a message starting with "wwa " or asks to run wwa commands, execute it via Shell immediately instead of explaining it.
173 chars✓ has a “when” trigger
Intermediate

Key capabilities

  • Execute `wwa` commands directly via Shell
  • Handle `wwa` commands with complete parameters
  • Use project root bootstrap scripts (`wwa.bat` or `./wwa`)
  • Create and install dependencies in `.venv` if missing
  • Output execution results concisely

How it works

The skill directly executes `wwa` commands via shell using project-specific bootstrap scripts, handling environment setup and outputting results.

Inputs & outputs

You give it
A user message starting with 'wwa ' or indicating intent to run wwa commands
You get back
The result of the executed `wwa` command (success/failure + key info)

When to use wwa-cli-runner

  • Initialize wwa projects
  • Start content creation tasks
  • Submit drafts via CLI
  • Display wwa command help

About this skill

WWA CLI Runner

何时使用

当用户消息满足以下任一条件时触发:

  1. 消息以 wwa 开头(如 wwa initwwa start --workspace .
  2. 消息意图是"运行 wwa"、"执行 wwa 命令"、"帮我调用 wwa"
  3. 用户输入 @wwa-cli-runner@wwa-cli-runner <参数>

拦截规则(优先于执行规则)

以下情况禁止直接运行 CLI,必须在对话中完成交互,收集到必要参数后再调用 CLI:

触发条件处理方式
用户输入裸 wwa(无任何子命令)转交 00-writewithai-workflow-manager,在对话中引导选题
用户输入 wwa 开始创作wwa start 且无 --topic在对话中询问选题(A 自有主题 / B 帮找热点),收集后再执行 wwa.bat start --workspace . --topic "<主题>"
任何会启动交互式 TUI/问答的命令同上,先在对话中完成交互,再用完整参数调用 CLI

原因:GitHub Copilot Chat 无法驱动终端 TUI,所有交互必须在对话窗口完成。

执行规则

  1. 有完整参数的命令,直接执行,不要解释。
  2. 使用项目根目录下的自举脚本执行命令:
    • Windows: wwa.bat <args>
    • Unix: ./wwa <args>
  3. 如果 .venv 不存在,自举脚本会自动创建并安装依赖,耐心等待安装完成。
  4. 执行完成后,简洁输出结果(成功/失败 + 关键信息)。

命令映射示例

用户输入执行命令
wwa init.\wwa.bat init (Win) / ./wwa init (Unix)
wwa start --workspace . --topic "AI写作".\wwa.bat start --workspace . --topic "AI写作"
wwa submit --draft-file data/02_human_drafts/x.md.\wwa.bat submit --draft-file data/02_human_drafts/x.md
@wwa-cli-runner --help.\wwa.bat --help
wwa / wwa 开始创作 / wwa start❌ 不执行,转入对话引导流程

When not to use it

  • When user input is bare `wwa`
  • When `wwa start` is used without `--topic`
  • When commands would start an interactive TUI/questionnaire

Limitations

  • The skill cannot drive terminal TUIs
  • The skill requires complete parameters for direct execution
  • The skill does not execute bare `wwa` commands

How it compares

This skill automates the direct execution of `wwa` CLI commands, bypassing interactive prompts that a manual user would encounter.

Compared to similar skills

wwa-cli-runner side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
wwa-cli-runner (this skill)03moNo flagsIntermediate
youtube-transcript689moReviewIntermediate
openai-whisper382moNo flagsBeginner
filler-word-processing11moNo flagsIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry