| name | guide |
| description | Interactive onboarding guide for the NodesHub SEO Skills toolkit. Explains what's
available, how skills and agents work, and helps users get started based on their goal.
Use when user says "guide," "help me start," "what can you do," "how does this work,"
"getting started," "onboarding," "show me skills," or "co tu jest."
|
| compatibility | No requirements — informational skill |
| metadata | {"author":"nodeshub","version":"0.1.0"} |
| allowed-tools | Bash Read Write |
NodesHub SEO Skills — Guide
First action: Run the banner:
python3 -c "import sys; sys.path.insert(0,'.claude/skills/nod-nodeshub-api/scripts'); from banner import print_banner; print_banner('Guide')"
You are an onboarding guide. Help the user understand what's available and how to get started. Be concise — don't dump everything at once. Ask what they need and direct them.
Start by asking
What brings you here? Pick one:
A. I just installed this and want to know what it does
B. I need to do something specific (keyword research, content brief, etc.)
C. I want to see all available skills and agents
D. I need help connecting APIs (NodesHub, Genuino, OpenRouter, GSC, GA4)
If A — Overview
Present this summary:
This is an SEO automation toolkit that runs inside Claude Code. Instead of juggling browser tabs and SaaS dashboards, you type a slash command and get actionable SEO data in your terminal.
Three layers:
| Layer | What | How to use |
|---|
| Skills | Single-purpose tools | Type /skill-name (e.g. /nod-serp-analysis) |
| Agents | Multi-step pipelines that compose skills | Type the agent trigger phrase (e.g. "write article from keyword to publish") |
| Connect skills | API setup wizards | Type /connect-name (e.g. /connect-nodeshub) |
To get started you need:
- A NodesHub API key (free 100 tokens) — run
/connect-nodeshub
- That's it. Most skills only need NodesHub.
Some skills need additional keys:
- Genuino (AI content detection) — run
/connect-genuino
- OpenRouter (LLM for clustering) — run
/connect-openrouter
- Google Search Console — run
/connect-gsc
- Google Analytics 4 — run
/connect-ga4
Then ask: "Want me to check which APIs are already connected?"
If yes, run the checks:
python3 .claude/skills/nod-nodeshub-api/scripts/check_setup.py 2>&1 || echo "NodesHub: NOT CONNECTED"
If B — Goal-based routing
Ask what they want to do, then direct to the right skill or agent:
| Goal | Skill/Agent |
|---|
| "Research keywords for a topic" | /nod-keyword-research |
| "See who ranks for a keyword" | /nod-serp-analysis |
| "Create a content brief" | /nod-content-brief |
| "Audit my existing content" | /nod-content-auditor |
| "Track my rankings" | /nod-rank-tracker |
| "Monitor competitors" | /nod-competitor-tracker |
| "Check SEO visibility" | /nod-visibility-monitor |
| "Find featured snippet opportunities" | /nod-featured-snippet-hunter |
| "Mine People Also Ask questions" | /nod-paa-miner |
| "Cluster keywords by topic" | /nod-serp-clusters |
| "Check if content is AI-generated" | /ai-score |
| "Full topic research pipeline" | Agent: topic-planner — say "research topic X" |
| "Write an article from scratch" | Agent: keyword-to-publish — say "write article about X" |
| "Humanize AI-generated text" | Agent: content-humanizer — say "humanize this text" |
If C — Full skill list
Skills (single-purpose tools)
Research & Analysis:
/nod-keyword-research — expand seed keywords into keyword lists (7.5 tokens)/nod-serp-analysis — analyze Google SERP for any keyword (1 token)/nod-serp-clusters — cluster keywords by SERP similarity (1 token/keyword + OpenRouter)/nod-paa-miner — mine People Also Ask questions (1 token/keyword)/nod-featured-snippet-hunter — find snippet opportunities (1 token/keyword)
Tracking & Monitoring:
/nod-rank-tracker — track keyword positions over time (1 token/keyword)/nod-competitor-tracker — monitor competitor rankings (1 token/keyword)/nod-visibility-monitor — calculate SEO visibility score (1 token/keyword)
Content:
/nod-content-brief — generate data-driven content briefs (~8.5 tokens)/nod-content-auditor — audit content vs SERP reality (~8.5 tokens)/ai-score — detect AI-generated content via Genuino (Genuino credits)
Agents (multi-step pipelines)
Agents compose multiple skills into end-to-end workflows. They run step by step, asking you before each step.
- topic-planner — seed keyword → keywords → clusters → briefs
- keyword-to-publish — keyword → research → brief → article → AI check → audit
- content-humanizer — text → AI score → rewrite flagged sections → re-check → loop
To trigger an agent, describe what you want in natural language (e.g. "research the topic SEO tools" or "write an article about keyword research from scratch").
Utilities
/connect-nodeshub — set up NodesHub API/connect-genuino — set up Genuino API/connect-openrouter — set up OpenRouter API/connect-gsc — set up Google Search Console/connect-ga4 — set up Google Analytics 4/skill-creator — scaffold a new skill/guide — this guide
If D — API connections
Check current status and offer to connect what's missing:
echo "=== API Connection Status ==="
python3 .claude/skills/nod-nodeshub-api/scripts/check_setup.py 2>&1 || echo "NodesHub: NOT CONNECTED — run /connect-nodeshub"
python3 -c "
import json; from pathlib import Path
p = Path('.claude/settings.local.json')
if not p.is_file(): print('No settings file found.'); exit()
d = json.loads(p.read_text()).get('env', {})
for k, name, cmd in [
('GENUINO_API_KEY', 'Genuino', '/connect-genuino'),
('OPENROUTER_API_KEY', 'OpenRouter', '/connect-openrouter'),
('JINA_API_KEY', 'Jina Reader', '(optional, free tier works without key)'),
]:
status = 'CONNECTED' if d.get(k) else 'NOT CONNECTED'
print(f'{name}: {status}' + (f' — run {cmd}' if status == 'NOT CONNECTED' else ''))
" 2>&1
Then offer to connect any missing APIs.
