| name | keywords-cli |
| description | Use this skill for service operations only. DO NOT use this skill for CLI implementation lifecycle work such as creating, testing, updating, troubleshooting, validating, removing, or documenting the CLI tool itself; delegate those tasks to cli-tool-expert. Execute keywords operations using the `keywords` CLI tool. Query autocomplete suggestions from search engines for keyword research -- Google, YouTube, Bing, Amazon, DuckDuckGo. Triggers: keywords, keywords cli, keyword research, autocomplete suggestions, search suggestions, keyword ideas, seo keywords, suggest keywords, keyword tool |
Execute keywords operations using the `keywords` CLI. All keyword research via autocomplete should use this CLI.
<quick_start>
The keywords CLI follows this pattern:
keywords suggest <action> [arguments] [options]
| Task | Command |
|---|
| Get keyword suggestions | keywords suggest query "python tutorial" --table |
| Multi-source suggestions | keywords suggest query "best laptop" -s google -s youtube -s amazon --table |
| Filter suggestions | keywords suggest query "seo" --filter "tool" --table |
| Recursive expansion | keywords suggest query "python" --recurse --depth 2 --table |
| List available sources | keywords suggest sources --table |
| </quick_start> | |
<essential_principles>
MANDATORY: Consult the adjacent usage.json at <cli-tools-root>/_repo/skills/<tool>-cli/usage.json before executing ANY keywords command.
This file contains complete command syntax, all arguments, all options, and usage instructions for every command. Never guess at command syntax.
- **suggest** -- Query autocomplete suggestions (query, sources)
<reference_index>
usage.json -- Complete command tree with arguments, options, defaults, and usage instructions for every command.
</reference_index>
<success_criteria>
- Command executes without error
- Output is displayed in requested format
- Correct command and flags used (verified against usage.json)
</success_criteria>
