Menu
Manage saved articles and workflow sessions. Save, load, list, and remove content.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
SEO research phase - keyword research, SEO strategy, topical maps, and content calendars.
Interactive setup wizard for Suparank. Creates project config and optional publishing credentials.
AI-powered SEO content creation toolkit. Research keywords, write optimized articles, and publish to WordPress/Ghost.
Content creation phase - write SEO-optimized articles and generate image prompts.
Content optimization phase - quality check, GEO optimization, internal links, and schema markup.
Full content creation pipeline - research, write, optimize, and publish SEO articles in one workflow.
| name | suparank/session |
| description | Manage saved articles and workflow sessions. Save, load, list, and remove content. |
| user_invocable | true |
You manage the user's content session - saved articles, workflow state, and content storage.
.claude/suparank-session.json (in project root).claude/suparank-content/ (in project root).claude/suparank.json (in project root)Detect what the user wants and execute the appropriate action:
Triggers: "show session", "session status", "what's in my session", "show my articles"
.claude/suparank-session.json/suparank to start."Session Status
══════════════
Workflow: [workflow_id]
Request: [original request]
Phase: [current_phase]
Articles: [saved count] / [total expected]
Articles:
1. [title] - [word_count] words - [status] - Saved [date]
2. [title] - [word_count] words - [status] - Saved [date]
...
Research: [Available / Not done]
Triggers: "list articles", "list saved content", "show past articles", "what articles do I have"
.claude/suparank-content/ directory exists/suparank to start."metadata.json to get title, date, word countDisplay:
Saved Articles
══════════════
1. 2026-02-23-how-ai-is-changing/
Title: How AI is Changing Content Marketing
Words: 2,800 | Keywords: AI content marketing
Saved: 2026-02-23 10:30
2. 2026-02-23-seo-best-practices/
Title: SEO Best Practices for 2026
Words: 3,100 | Keywords: SEO best practices
Saved: 2026-02-23 11:45
Triggers: "save this article", "save content", "save my article"
This is typically called automatically by the pipeline/create skills, but can be invoked manually.
The user should provide or have just written:
Generate a folder name: YYYY-MM-DD-slug-from-title
Create the directory: .claude/suparank-content/[folder-name]/
Write the article to article.md
Write metadata to metadata.json:
{
"title": "Article Title",
"slug": "article-title",
"version": 1,
"keywords": ["keyword1", "keyword2"],
"meta_description": "SEO description...",
"word_count": 2800,
"saved_at": "2026-02-23T10:30:00Z",
"updated_at": "2026-02-23T10:30:00Z",
"published_to": [
{
"platform": "wordpress",
"post_id": "12345",
"url": "https://myblog.com/article-title",
"published_at": "2026-02-23T11:00:00Z",
"status": "draft"
}
],
"image_urls": [
{
"url": "https://fal.ai/...",
"alt_text": "Article hero image",
"type": "cover"
}
]
}
When updating an existing article, increment version and update updated_at.
.claude/suparank-session.json to add this article to the articles array:{
"workflow_id": "wf_[timestamp]",
"articles": [
{
"id": "article-1",
"title": "Article Title",
"folder": ".claude/suparank-content/2026-02-23-article-title/",
"keywords": ["keyword1"],
"meta_description": "...",
"word_count": 2800,
"status": "saved",
"published_to": [],
"image_urls": [],
"saved_at": "2026-02-23T10:30:00Z"
}
],
"saved_at": "2026-02-23T10:30:00Z"
}
Triggers: "load article", "open article", "bring back article", "edit my article about..."
.claude/suparank-content/article.md and metadata.json from the folder.claude/suparank-session.jsonTriggers: "remove article", "delete from session", "remove article 2"
.claude/suparank-session.json.claude/suparank-content/ - just removes from active sessionTriggers: "clear session", "start fresh", "reset session"
.claude/suparank-session.json to:{
"workflow_id": null,
"articles": [],
"research_results": {},
"saved_at": null
}
Triggers: "delete article files", "permanently delete", "remove saved files"
.claude/suparank-content/The session file .claude/suparank-session.json tracks the current workflow:
{
"workflow_id": "wf_1709234567890",
"request": "Write 3 articles about AI content tools",
"current_phase": "creation",
"total_articles": 3,
"articles": [
{
"id": "article-1",
"title": "How AI is Changing Content Marketing",
"folder": ".claude/suparank-content/2026-02-23-how-ai-is-changing/",
"keywords": ["AI content marketing"],
"meta_description": "...",
"word_count": 2800,
"status": "saved",
"published_to": [],
"image_urls": [],
"saved_at": "2026-02-23T10:30:00Z"
}
],
"research_results": {
"keywords": {
"primary": [
{ "keyword": "AI content tools", "volume": "2.4K", "difficulty": 35, "intent": "commercial" }
],
"longtail": [
{ "keyword": "best AI tools for blog writing", "volume": "720", "difficulty": 18, "content_type": "listicle" }
],
"questions": [
{ "question": "What are the best AI content tools?", "volume": "590", "snippet_opportunity": true }
],
"selected_primary": "AI content tools",
"selected_secondary": ["AI writing software", "content automation"]
},
"seo_strategy": {
"search_intent": "commercial",
"content_type": "listicle",
"recommended_title": "10 Best AI Content Tools in 2026",
"outline": ["Introduction", "Tool 1...", "Conclusion", "FAQ"]
},
"topical_map": {
"pillar": "AI Content Tools Guide",
"clusters": ["AI writing tools", "AI SEO tools", "AI image tools"]
},
"content_calendar": {
"articles": [
{ "order": 1, "title": "...", "keyword": "...", "type": "guide" }
]
}
},
"saved_at": "2026-02-23T10:30:00Z"
}
Before writing ANY files, ALWAYS run:
mkdir -p .claude/suparank-content
This ensures both .claude/ and .claude/suparank-content/ exist.
YYYY-MM-DD-slug-from-titleversion in metadata.json and update updated_at