awesome-tools — Claude Code skill: what it does, how to install
Claude Code skill automates software product submissions to Awesome Tools via JSON API. Runs when requesting directory listings.
no license 428 installs ★ 1,797 updated 2026-11-16
npx skills add Illyism/seo-skills --skill awesome-tools -a claude-codeWhat awesome-tools does
The skill sends product details to the Awesome Tools API, runs preliminary validations with dryRun, and records budgets or goals. It requires a product name, a public website, and an authorized contact email. No API key is required.
The endpoint accepts application/json payloads up to 16 KiB. After submission, the agent returns status and completion links. Both free backlink paths and paid listing options are supported.
What it helps with
- submit software to the Awesome Tools directory
- validate submission data before sending requests
- specify promotional budgets and product goals
- configure free or paid listing paths
Example prompts for the agent
- Submit our product to Awesome Tools
- Run a dry run validation for the directory submission
- Prepare the software details for awesome-tools
How to install awesome-tools
1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill awesome-tools -a claude-code2Manually: put the files in place
~/.claude/skills/awesome-tools/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/awesome-tools/
1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill awesome-tools -a codex2Manually: put the files in place
.agents/skills/awesome-tools/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill awesome-tools -a cursor2Manually: put the files in place
.cursor/skills/awesome-tools/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Illyism/seo-skills seo/awesome-tools/SKILL.md2Manually: put the files in place
.github/skills/awesome-tools/SKILL.md1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill awesome-tools -a gemini-cli2Platform CLI
gemini skills install https://github.com/Illyism/seo-skills --path seo/awesome-toolsManually: put the files in place
.devin/skills/awesome-tools/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill awesome-tools -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about awesome-tools
How to install awesome-tools in Claude Code?
Run npx skills add Illyism/seo-skills --skill awesome-tools -a claude-code followed by ~/.claude/skills/awesome-tools/SKILL.md.
What does awesome-tools do?
It automates software submissions to the Awesome Tools directory via API, validates fields, and handles free or paid listing options.
What is required to run awesome-tools?
You need a public website, an authorized contact email, and permission from the project owner.