This source did not publish a separate summary. Review SKILL.md before using the skill.
SKILL.md
Trend & Intent Scout — Skill Instructions
Overview
Find what your audience is searching for right now. This skill combines real-time social signals from X/Twitter and Reddit with SEO intelligence — giving you trending topics, competitor deep-dives, and content gaps in one workflow.
What sets this apart from DataForSEO or Semrush: those tools show you historical search volume. This skill shows you what people are talking about today on social — and maps those signals directly to content opportunities your competitors haven't covered yet.
Use cases:
Morning briefing: what's blowing up in your niche right now?
Competitor research: what's their content strategy and where are their gaps?
Content calendar: find topics with social traction before they peak in SEO tools
Market research: understand audience intent at the conversation level
When to Use
Situation
What to do
"What should I write about today?"
Scout X + Reddit for trending topics in your niche
"What is my competitor doing?"
Discover + analyze competitor domains
"What content am I missing?"
Generate content gaps vs competitor URLs
"Morning briefing on AI trends"
Full workflow: X scout + Reddit scout + gaps
"Find competitors in [niche]"
Discover competitors by keywords
Instructions
Setup (run once)
If you don't have a saved API key for Citedy, run this flow:
1. Register
Preferred: run the included registration script:
node scripts/register.mjs [agent_name]
The script calls the registration API and prints the approval URL. If is omitted, it defaults to .
agent_name
agent-<hostname>
Alternative: call the API directly:
POST https://www.citedy.com/api/agent/register
Content-Type: application/json
{"agent_name": "<your_agent_name>"}
X scout requires topics with sufficient public English-language conversation (min ~100 recent posts)
Reddit scout works best for niches active on Reddit; B2B topics may have fewer results
Gaps generate analyzes content at the URL level — paywalled or JS-only content may not be fully indexed
Competitor scout covers publicly accessible content only
Async runs expire after 24 hours — poll results within that window
Scout results reflect data at time of run; real-time trends can shift within hours
Error Handling
HTTP Status
Code
Meaning
401
unauthorized
Invalid or missing API key
402
insufficient_credits
Not enough credits for this operation
404
run_not_found
Run ID doesn't exist or expired
422
validation_error
Invalid request parameters
429
rate_limited
Too many requests — check X-RateLimit-Reset header
500
internal_error
Server error — run will be auto-refunded
Error response format:
{
"error": {
"code": "insufficient_credits",
"message": "This operation requires 35 credits, you have 12.",
"required": 35,
"available": 12
}
}
On 429: Wait until X-RateLimit-Reset timestamp, then retry.
On 500: The run is automatically refunded. Retry after 30 seconds.
Response Guidelines
When presenting scout results to the user:
Lead with action — don't just list topics, suggest the best content angle for each
Prioritize by opportunity — sort by engagement_score or relevance, not alphabetically
Cross-reference signals — a topic trending on both X and Reddit is a stronger signal than one platform alone
Connect gaps to trends — the best opportunities are content gaps that are also trending
Be specific — "Write about AI tools" is useless; "Write a comparison of Jasper vs Citedy targeting budget-conscious e-commerce teams (trending on r/SEO, 847 upvotes)" is actionable
Want More?
This skill covers trend scouting, competitor analysis, and content gaps.
For the full Citedy agent suite:
Article Autopilot — generate full SEO articles from topics found here
Social Poster — adapt articles to LinkedIn, X, Reddit, Instagram automatically
Video Shorts — turn articles into short-form video content
Lead Magnets — create checklists, swipe files, and frameworks from your content
