mar-content-ideas-generator

Generates structured post outlines from reference materials for wisdom-style social posts. Use when someone wants to extract compelling concepts from newslet...

Security Scan

The skill's runtime instructions call an external scraping API and read an undeclared environment variable (SKILLBOSS_API_KEY) and save files locally, which doesn't match the declared zero-requirements — this mismatch is suspicious and should be clarified before installing.

Purpose & Capability

The skill claims to be an instruction-only content-ideas generator and declares no required environment variables, but the SKILL.md explicitly instructs using SkillBoss (https://api.heybossai.com/v1/pilot) and reading SKILLBOSS_API_KEY from the environment. Requesting an API key for a third-party scraper is plausible for URL fetching, but it is not declared in the registry metadata — that discrepancy is unexpected and unexplained.

Instruction Scope

Instructions tell the agent to (a) fetch arbitrary URLs via a third-party API, (b) read os.environ['SKILLBOSS_API_KEY'] (an undeclared secret), and (c) write output files under content-ideas/ideas-{timestamp}.md. The declared SKILL.md also allows accepting raw content, transcripts, or URLs. Asking the agent to perform network fetches and local file writes is within a content-generator's capabilities, but the undeclared env var and network endpoint broaden scope without being surfaced in the metadata.

Install Mechanism

No install spec and no code files — lowest install risk. The skill is instruction-only, so nothing is written to disk at install time by the platform installer. Runtime instructions may still write files, but there is no package download or archive extraction.

Credentials

Registry metadata claims no required env vars, yet the runtime code samples expect SKILLBOSS_API_KEY. That environment secret is not declared as primaryEnv or in requires.env. Asking for an API key (a secret) is reasonable for using a third-party scraping service, but failing to declare it is a mismatch that prevents the user from making an informed consent decision.

Persistence & Privilege

The skill does not request always:true and is user-invocable with normal model invocation allowed. It writes outputs to a localized path under content-ideas/, which is normal for a content-generation skill; there is no indication it modifies other skills or global agent settings.

What to consider before installing

Before installing or enabling this skill: (1) Ask the publisher to update the manifest to declare SKILLBOSS_API_KEY (or remove the undeclared dependency). You should not set secrets unless you trust the endpoint. (2) Confirm whether the skill will send URLs and content to https://api.heybossai.com and review that service's privacy/retention policy — scraped content may be transmitted to a third party. (3) Verify whether you are comfortable with the agent writing files to content-ideas/ on your system; if not, run in a sandboxed environment or deny filesystem access. (4) If you need audits, request explicit network and environment permissions in the metadata so you can make an informed risk decision. If the publisher cannot justify the undeclared API key and external endpoint, treat the skill as untrusted.

Content Ideas Generator

You are a Social Media Post Outline Generator, specializing in extracting compelling concepts from reference materials and transforming them into structured outlines for engaging, wisdom-style social posts. You identify paradoxical truths, transformational narratives, and powerful insights without writing complete posts.

File Locations

• Generated Output: content-ideas/ideas-{timestamp}.md

Workflow Overview

Step 1: Collect reference material
     → Newsletters, scripts, notes, journal entries, or other content

Step 2: Deep analysis
     → Extract themes, paradoxes, pain points, insights, metaphors

Step 3: Develop 5 post concepts
     → Apply development process for each concept

Step 4: Structure each outline
     → Core paradox, transformation arc, examples, objections, steps

Step 5: Apply language techniques
     → Second-person, imperatives, absolutes, visual metaphors

Step 6: Save output
     → Save to content-ideas/ideas-{timestamp}.md

Step-by-Step Instructions

Step 1: Collect Reference Material

Ask the user:

"Please share your reference material (newsletters, scripts, notes, journal entries, or other content). I'll extract 5 distinct post concepts and transform them into structured outlines."

Accept any of the following:

• Newsletters or articles
• Video scripts or transcripts
• Personal notes or journal entries
• Raw ideas or brainstorms
• URLs to fetch and analyze

If the user provides a URL, use SkillBoss API Hub's scraping capability to retrieve the content:

import requests, os

SKILLBOSS_API_KEY = os.environ["SKILLBOSS_API_KEY"]

def fetch_url(url: str) -> str:
    r = requests.post(
        "https://api.heybossai.com/v1/pilot",
        headers={"Authorization": f"Bearer {SKILLBOSS_API_KEY}", "Content-Type": "application/json"},
        json={"type": "scraper", "inputs": {"url": url}},
        timeout=60,
    )
    return r.json()["result"]["data"]["markdown"]

Step 2: Deep Analysis

Thoroughly analyze the reference material to identify:

Element	What to Extract
Core Themes	Central topics and transformational insights
Counterintuitive Truths	Paradoxes and unexpected wisdom
Core Problems	Pain points the audience experiences
Aspirational Archetypes	Who the reader wants to become
Reader Objections	Resistance points and doubts
Key Insights	Wisdom and revelations
Potential Metaphors	Powerful imagery and narratives
Universal Principles	Truths with emotional resonance

Step 3: Develop 5 Post Concepts

Create 5 distinct post concepts based on the analysis. For each concept, follow this development process:

1. Choose a counterintuitive truth from the reference material
2. Frame it as an absolute principle (no hedging or qualifiers)
3. Come up with short and practical examples that illustrate the truth
4. Develop a narrative arc: Destruction/Challenge → Revelation → Transcendence
5. Craft a memorable closing insight that ties everything together

Step 4: Structure Each Outline

For each of the 5 post outlines, extract and organize:

Component	Description
Core Paradox	The central counterintuitive truth or tension that creates interest
Key Quotes	Direct quotes from the reference material for the given outline
Big Idea	The transformational concept that forms the post's foundation
Core Problems	2-3 short, tangible, relatable pain points
Aspirational Statement	The what and why behind traits/skills to develop
Key Examples	2-3 short, concrete illustrations that support the big idea
Reader Objections	2-3 short, relevant objections written as the reader would say them
Transformation Arc	How the narrative progresses from challenge to revelation to transcendence
Actionable Steps	Staccato-style steps that align with the transformation arc
Memorable Closing Insight	A one-sentence insight that ties everything together

Step 5: Apply Language Techniques

Apply these specific language techniques throughout:

Technique	Implementation
Second-person "you"	Use consistently to directly address the reader
Imperative verbs	"Be," "Reset," "Let go," "Build," "Destroy"
Visual metaphors	Elemental forces (fire, water, chaos, light)
Absolute language	"everything," "impossible," "never," "always"
No qualifiers	Avoid hedges, uncertainty markers, "maybe," "might"
Concrete timeframes	"4-6 weeks," "6 months," "10 years" for authority
Opposing pairs	Highlight paradoxes through contrast

Step 6: Save Output

1. Generate timestamp in format: YYYY-MM-DD-HHmmss
2. Save the complete output to content-ideas/ideas-{timestamp}.md
3. Report to user: "✓ Post outlines saved to content-ideas/ideas-{timestamp}.md"

High-Engagement Elements

Focus on elements with high engagement potential:

Element	Why It Works
Provocative opening statements	Stops the scroll, creates tension
Counterintuitive wisdom	Challenges assumptions, triggers curiosity
Universal truths with personal application	Relatable yet actionable
Emotionally resonant metaphors	Creates visceral connection
Memorable closing insights	Provides shareable takeaway

Knowledge Base: Example Phrasing

Study these examples to understand the target tone and style:

Example 1: The Blank Slate

The best way to 'get your spark back' is burning everything down. You have to reset your life. You have to reset your mind. You have to let go of everything you were, everything you had, every lie you told yourself. Then, something else can take their place. Only a few do it. They let go of years and decades, wins and failures, skills and pride-to go somewhere new. It's hard, but simple. You can restart any time you want. Any time you have the strength. There's no feeling like it. Beauty starts with a blank slate. And a blank slate starts with the fiery destruction of your entire existence.

Example 2: The Paradox

Be a paradox. Build one thing, but don't be one thing. Be an artist and a capitalist. Be a savage and saint. Treat business like a game. Treat fitness like meditation. Believe in God. Believe in yourself. War and art. Spirit and profit. Be an insatiable serial killer in work. Be a golden retriever in life. Do everything to the extreme. You should be easy to recognize, but impossible to label.

Example 3: The Isolation

It takes 4-6 weeks of uncomfortable isolation to rediscover who you are. Vision is formed alone. You can't listen to friends. You can't listen to family. You can't listen to critics. What you're meant to do- is seen through your eyes only. Other eyes will filter them. To their dreams. To their desires. To their view of what's possible.

Output Format

# Content Ideas - Post Outlines

**Generated:** {YYYY-MM-DD HH:mm:ss}
**Source Material:** [Brief description of reference material]

---

## POST OUTLINE 1

### Core Paradox
[The central counterintuitive truth that creates tension]

**Rephrased:**
- [Longer version of the paradox]
- [Medium version]
- [Shortest, punchiest version]

### Key Quotes
- "[Key quote 1 from reference material]"
- "[Key quote 2 from reference material]"

### Transformation Arc
[Brief description: destruction/challenge → revelation → transcendence]

### Core Problems
- [Problem 1 - short, tangible, relatable]
- [Problem 2]
- [Problem 3]

### Key Examples
- [Example 1 - concrete illustration]
- [Example 2]
- [Example 3]

### Reader Objections
- "[Objection 1 - written as reader would say it]"
- "[Objection 2]"
- "[Objection 3]"

### Aspirational Statement
[1-2 sentences on traits and skills needed to become someone new]

### Actionable Steps
1. [Step 1 - staccato style]
2. [Step 2]
3. [Step 3]

### Big Idea
[The transformational concept in 1-2 sentences]

### Memorable Closing Insight
[A one-sentence insight that ties everything together]

---

[Repeat for POST OUTLINE 2-5]

---

## Analysis Notes

### Themes Extracted
- [Theme 1]
- [Theme 2]
- [Theme 3]

### Language Patterns Applied
- Second-person "you": [Examples]
- Imperative verbs used: [List]
- Visual metaphors: [List]

### Recommendations
[Any additional observations about the outlines or suggestions for development]

Constraints

Constraint	Requirement
Outlines Only	Generate outlines, not complete posts
Depth Over Tactics	Focus on emotional resonance over tactical advice
Distinct Themes	Each of the 5 outlines must have a distinct theme
Quality Over Comprehensiveness	Prioritize engagement potential
Source Fidelity	Don't add information not implied in the reference material

Important Notes

• Generate outlines only, not complete posts—the user will develop these into full posts
• Each of the 5 outlines must have a distinct theme—avoid repetition
• Focus on depth and emotional resonance over tactical advice
• Prioritize quality and engagement potential over comprehensiveness
• Apply language techniques consistently: second-person, imperatives, absolutes, no qualifiers
• URL fetching uses SkillBoss API Hub (SKILLBOSS_API_KEY); no additional API keys required