@opendirectory.dev/skills 0.1.45 → 0.1.47

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opendirectory.dev/skills",
-  "version": "0.1.45",
+  "version": "0.1.47",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {

package/registry.json

@@ -196,6 +196,14 @@
     "version": "1.0.0",
     "path": "skills/newsletter-digest"
   },
+  {
+    "name": "noise-to-linkedin-carousel",
+    "description": "Transforms messy, unstructured source material (transcripts, rough notes, etc.",
+    "tags": [],
+    "author": "ajaycodesitbetter",
+    "version": "1.0.0",
+    "path": "skills/noise-to-linkedin-carousel"
+  },
   {
     "name": "noise2blog",
     "description": "Turns rough notes, bullet points, voice transcripts, or tweet dumps into a polished, publication-ready blog post.",

package/skills/cold-email-verifier/README.md

@@ -4,6 +4,9 @@ Agent Skill that equips your AI agent with the ability to autonomously guess, en
 
 Instead of running Python scripts manually, this skill teaches your AI how to read your lead lists, discover corporate domains via the Clearbit API, generate standard email permutations, and securely verify them.
 
+<img width="2752" height="1536" alt="cold-email-verifier-cover-image" src="https://github.com/user-attachments/assets/f033ec61-d2c1-4cee-a6d5-71e7cf9632a6" />
+
+
 ## Install
 
 ```bash

package/skills/noise-to-linkedin-carousel/README.md

@@ -0,0 +1,81 @@
+![noise-to-linkedin-carousel](./cover.png)
+
+# noise-to-linkedin-carousel
+
+**noise-to-linkedin-carousel** turns rough notes, transcripts, and idea dumps into a LinkedIn-ready carousel content pack with a strong hook, clear slide-by-slide structure, and a CTA — built for founders, GTM teams, and technical marketers who think faster than they write.
+
+## Why This Skill?
+
+Founders and technical operators often think in fragments: voice notes, bullet dumps, rambling transcripts, or Slack thoughts. They have valuable insights but lack a repeatable workflow to convert those noisy inputs into highly readable, LinkedIn-native carousel content.
+
+LinkedIn carousels routinely outperform single-image or text-only posts because they encourage swipe-through engagement and let you teach in a structured, visual way. While `linkedin-post-generator` focuses on crafting a single post, **noise-to-linkedin-carousel** is designed specifically to turn messy raw thinking into a multi-slide narrative that a founder, GTM engineer, or designer can immediately turn into a carousel asset.
+
+This agent skill helps by taking that unstructured "noise" and transforming it into a structured asset pack containing:
+- 3 strong cover hook options
+- 5-9 correctly sized insight slides (one idea per slide)
+- A clear narrative progression
+- A custom CTA slide
+- A supporting LinkedIn caption
+
+## Prerequisites
+
+- [OpenDirectory CLI](https://github.com/Varnan-Tech/opendirectory)
+- An OpenDirectory-compatible agent (e.g., **Anti-Gravity** or **OpenCode**)
+
+## Installation
+
+Install directly into your agent via OpenDirectory:
+```bash
+npx "@opendirectory.dev/skills" install noise-to-linkedin-carousel --target anti-gravity
+```
+*(Replace `anti-gravity` with your preferred agent target.)*
+
+## Usage Examples
+
+Once installed, you can simply message your agent with noisy source material. 
+
+**Example Prompt:**
+> I recorded this rough voice note about why most devtools marketing fails. It’s a rant, not a clean outline. Here’s the transcript — turn this into a LinkedIn carousel I can hand to my designer:  
+>  
+> “okay so basically what i realized is that most devtools fail because they market features not use cases like everyone lists api endpoints and configs but nobody explains when you’d actually use this thing in production you know what i mean and founders think more features will solve it but the buyer just wants to know what problem disappears after they install you and how fast they get there”
+
+**Sample Output Shape:**
+
+- **Thesis:**  
+  Most devtools fail because they market features instead of clear, real-world use cases.
+
+- **Hooks (3 options):**  
+  1. “90% of devtools die because they market features, not outcomes.”  
+  2. “Your devtool doesn’t have a feature problem. It has a use-case problem.”  
+  3. “If your devtool landing page looks like an API manual, this is for you.”
+
+- **Slide Breakdown (example):**  
+  - **Slide 1 – Cover (Hook):** One of the hooks above.  
+  - **Slide 2 – Problem:** What most devtools marketing looks like today.  
+  - **Slide 3 – Insight:** Buyers buy outcomes and solved problems, not endpoints.  
+  - **Slide 4 – Insight:** Why “more features” doesn’t fix the positioning gap.  
+  - **Slide 5 – Example:** Before/after example of reframing features as use cases.  
+  - **Slide 6 – Framework:** Simple checklist to rewrite your own devtool pitch.  
+  - **Slide 7 – CTA:** Ask readers to audit their landing page or share with a founder.
+
+- **Caption:**  
+  A LinkedIn-ready caption that tees up the carousel, adds 1–2 sentences of context, and ends with a natural CTA (e.g., “Reply ‘DEVS’ if you want a teardown of your current page”), plus 2–4 relevant hashtags.
+
+## Under the Hood
+
+Unlike simple text generators, this skill operates as a structured workflow:
+1. **Thesis Extraction** - It strips away the noise to find the actual point.
+2. **Hook Selection** - It maps the thesis to known high-performing LinkedIn hook patterns.
+3. **Slide Constraint Enforcement** – It forces one main idea per slide and short, punchy copy so the deck feels like a high-signal LinkedIn carousel, not a pasted blog post.
+
+## File Architecture
+
+- `SKILL.md` - Core workflow instructions and formatting constraints.
+- `references/output-format.md` - The deterministic output schema.
+- `references/hook-patterns.md` - High-performing hook structures.
+- `references/slide-types.md` - Rules for cover, context, insight, and CTA slides.
+- `references/quality-checklist.md` - GTM-aligned checks run before returning output.
+
+## Contributing
+
+Pull requests to refine hook patterns, add new slide structures, or include helper scripts that refine raw transcripts are welcome.

package/skills/noise-to-linkedin-carousel/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: noise-to-linkedin-carousel
+description: Transforms messy, unstructured source material (transcripts, rough notes, etc.) into a polished, structured LinkedIn carousel content pack for founders and GTM teams.
+author: ajaycodesitbetter
+version: 1.0.0
+---
+
+# noise-to-linkedin-carousel
+
+You are an expert ghostwriter, technical marketer, and content strategist specializing in LinkedIn distribution. Your task is to take noisy source material and transform it into a structured, highly valuable LinkedIn carousel content pack.
+
+## Input Considerations
+The user will provide source material which may be:
+- Raw voice note transcripts
+- Bulleted brain dumps
+- Launch notes or Slack thoughts
+- Article or blog excerpts
+
+## Core Workflow
+
+You must follow these steps precisely to fulfill the user's request:
+
+### Step 1: Analyze and Extract Formulation
+Read the noisy input. Before drafting any content:
+1. Extract the strongest Distilled Thesis.
+2. Determine the Audience Angle.
+3. Identify the Content Goal (educate, provoke, summarize, convert, or inspire).
+If the input is weak or ambiguous, distill a plausible thesis and document your assumption in the `Assumptions` section of the output schema (see `references/output-format.md`). Omit that section if no assumptions are needed.
+
+### Step 2: Establish the Structure
+Determine the optimal length (5-9 slides). Map out a narrative arc determining which Slide Role each slide will play (Cover, Problem, Reframe, Insight, Framework, Example, Proof, Takeaway, CTA).
+*Refer to `references/slide-types.md` for understanding the exact nature and execution rules of these slide roles.*
+
+### Step 3: Generate Hooks
+Draft 3 distinct cover hook options explicitly labeled with the pattern used.
+*Refer to `references/hook-patterns.md` for the formulas needed.*
+
+### Step 4: Draft the Slide-by-Slide Content
+Create the content. You must adhere strictly to the quality constraints:
+- One main idea per slide.
+- Short, punchy copy. Absolutely no large paragraphs.
+- Provide a visual direction/intent for each slide indicating how a designer should construct it.
+*Review `references/quality-checklist.md` during drafting and perform a strict rubric check to ensure high standards.*
+
+### Step 5: Final Output Generation
+Format the final response strictly and deterministically according to the schema provided in `references/output-format.md`.
+
+## Tone and Style Constraints
+- Clear, sharp, and founder-friendly.
+- Educational, credible, and practical.
+- AVOID: Vague motivational fluff, heavy jargon without context, or cliché "growth-hacking" tones.
+
+Return ONLY the structured markdown response expected by the output schema.

package/skills/noise-to-linkedin-carousel/references/hook-patterns.md

@@ -0,0 +1,45 @@
+# Hook Patterns
+
+A strong hook on Slide 1 is critical for LinkedIn carousels. Expand beyond generic statements and use these specific patterns when generating the "Hook Options":
+
+## 1. The Contrarian Hook
+- **What it does:** Goes against common industry advice or accepted "best practices."
+- **When to use it:** When the source material debunks a myth or introduces a paradigm shift.
+- **Examples:**
+  - "Stop prioritizing features. Here is why the best product teams ship less."
+  - "The 'best' marketing channels are dead. Do this instead."
+
+## 2. The Mistake Hook
+- **What it does:** Agitates a specific pain point or error the audience is currently making.
+- **When to use it:** When the carousel acts as a corrective guide.
+- **Examples:**
+  - "90% of GTM engineers make this one mistake when launching Open Source tools."
+  - "Your devtool doesn't have a feature problem. It has a use-case problem."
+
+## 3. The Operator Lesson Hook
+- **What it does:** Shares a hard-won, tactical lesson from the trenches.
+- **When to use it:** When the source material shares personal, company, or team learnings.
+- **Examples:**
+  - "We spent 6 months building the wrong API. Here are the 5 red flags we missed."
+  - "How we scaled our technical documentation to 10k readers with 0 budget."
+
+## 4. The Framework Hook
+- **What it does:** Promises a clear, structured, step-by-step path to success.
+- **When to use it:** When the input provides a highly structured methodology to follow.
+- **Examples:**
+  - "The 4-step framework we use to write product docs that developers actually read."
+  - "A simple, repeatable system to onboard enterprise users in 5 days."
+
+## 5. The Teardown Hook
+- **What it does:** Analyzes a recognizable success or failure.
+- **When to use it:** When the source material reviews other companies, products, or strategies.
+- **Examples:**
+  - "Stripe's documentation is a masterclass. Here is a 5-minute teardown of why."
+  - "Why [Company X] failed their launch (and the 3 things you can learn from it)."
+
+## 6. The Pattern-Break Hook
+- **What it does:** Uses extreme brevity or bold formatting to stop the scroll immediately.
+- **When to use it:** When the thesis is incredibly simple but powerful.
+- **Examples:**
+  - "Nobody cares about your features."
+  - "Your pricing model is broken."

package/skills/noise-to-linkedin-carousel/references/output-format.md

@@ -0,0 +1,59 @@
+# Output Format Schema
+
+When returning the LinkedIn carousel content pack, you MUST format your response deterministically according to this exact schema. 
+
+## Assumptions *(optional)*
+Use this section **only** when the source input is weak, ambiguous, or too sparse to extract a clear thesis. State what you assumed and why.  
+**Omit this section entirely when the input is sufficient.**
+
+
+
+## 1. Distilled Thesis
+**Thesis:** *[One sharp, clear sentence capturing the core idea that the entire carousel will communicate. No jargon.]*
+
+## 2. Audience Angle
+**Target Audience & Angle:** *[A short statement explaining exactly who this carousel is for, and why this specific angle is highly relevant to them.]*
+
+## 3. Content Goal
+**Goal:** *[Educate, provoke, summarize, convert, or inspire. What should the reader feel at the end?]*
+
+## 4. Hook Options
+**Hooks:**  
+Offer 3 alternative cover-slide hook lines to grab attention, citing the pattern used.
+- **Option 1 ([Hook Pattern Name]):** *[Text]*
+- **Option 2 ([Hook Pattern Name]):** *[Text]*
+- **Option 3 ([Hook Pattern Name]):** *[Text]*
+
+## 5. Recommended Carousel Structure
+**Slide Count:** *[e.g., 7 slides]*
+
+## 6. Slide-by-Slide Breakdown
+
+Produce a detailed breakdown for each slide. Each slide should focus on ONE core idea.
+
+### Slide 1: Cover
+- **Slide Role:** Cover
+- **Slide Title / Headline:** *[The chosen best hook from above]*
+- **Visual Direction:** *[e.g., Large bold text centered, dark background with subtle neon accent]*
+
+### Slide 2: [Slide Role (e.g., Problem)]
+- **Slide Role:** *[e.g., Problem, Reframe, Insight, Proof, etc.]*
+- **Slide Title / Headline:** *[Short, punchy headline]*
+- **Slide Body Copy:** *[Concise body copy (no long paragraphs, bullet points preferred)]*
+- **Visual Direction:** *[e.g., Two-column layout: text on left, simple diagram on right]*
+
+*[Repeat for Slides 3 to N-1 as appropriate, ensuring fluid narrative progression...]*
+
+### Slide [N]: CTA (Call to Action)
+- **Slide Role:** CTA
+- **Slide Title / Headline:** *[Clear takeaway or action prompt]*
+- **Slide Body Copy:** *[What the user should do next (e.g., Follow, subscribe, comment)]*
+- **Visual Direction:** *[e.g., Profile picture, arrow pointing to the "Follow" button]*
+
+## 7. Supporting LinkedIn Caption
+**Caption:**  
+*[A caption to post alongside the document on LinkedIn. It should complement the slide deck, add 1-2 sentences of context without repeating verbatim, pose a question or brief hook, and include 3-5 relevant hashtags.]*
+
+## 8. Designer Handoff (Optional)
+**Visual/Formatting Guidance:**  
+*[Brief notes for the person or tool building the carousel (e.g., formatting styles, hierarchy, or structural intent limits).]*

package/skills/noise-to-linkedin-carousel/references/quality-checklist.md

@@ -0,0 +1,12 @@
+# Quality Checklist Rubric
+
+Before finalizing the output for the user, aggressively evaluate the draft against this strict grading rubric:
+
+- [ ] **One idea per slide:** Does any slide contain more than one distinct point? If yes, split it into two slides or delete one point.
+- [ ] **No duplicated points:** Does Insight 3 just re-say Insight 1 differently? Ensure every slide earns its place.
+- [ ] **No paragraph-heavy slides:** Are there walls of text? Ensure all body copy is scannable (short sentences or 2-3 bullets).
+- [ ] **Intentional slide flow:** Does the progression (Problem -> Reframe -> Insight -> Framework) logically build momentum?
+- [ ] **Meaningfully distinct hooks:** Are the 3 provided cover hooks truly different from one another (using different formulas)?
+- [ ] **Specific CTA:** Does the call-to-action make a specific request tied to the topic, rather than a generic "like and subscribe"?
+- [ ] **Complementary caption:** Does the LinkedIn caption add value without just summarizing the slides verbatim?
+- [ ] **Target audience alignment:** Does the output fit a founder, GTM engineer, or technical marketing use case? (No overly generic life-coach fluff.)

package/skills/noise-to-linkedin-carousel/references/slide-types.md

@@ -0,0 +1,57 @@
+# Slide Types & Taxonomy
+
+Use these defined slide roles when structuring the slide sequence in the content pack. 
+
+## Cover
+- **Purpose:** Stops the scroll. The hook that buys you attention.
+- **When to Use:** Always the first slide (Slide 1).
+- **Copy:** Massive contrast, highly clickable headline. Very little other text.
+- **Avoid:** Subtitles that are too long, or introducing the solution immediately.
+
+## Problem
+- **Purpose:** Agitates the pain point or sets the stage. Why does the reader need to keep swiping?
+- **When to Use:** Usually Slide 2, right after the cover.
+- **Copy:** Short statement of the status quo and why it hurts.
+- **Avoid:** Blaming the reader directly without empathy; getting bogged down in edge cases.
+
+## Reframe
+- **Purpose:** Shifts the reader's perspective on the problem.
+- **When to Use:** After the problem, before the deep insights.
+- **Copy:** "Instead of X, think Y." A punchy paradigm shift.
+- **Avoid:** Generic platitudes. It must be a specific paradigm shift.
+
+## Insight
+- **Purpose:** The "meat" of the carousel. One specific, strong point per slide.
+- **When to Use:** The core body of the carousel (Slides 3-6). 
+- **Copy:** One clear, declarative sentence and optionally 1-3 crisp bullets.
+- **Avoid:** Mixing multiple ideas. If there are 3 insights, use 3 separate insight slides.
+
+## Framework
+- **Purpose:** A sequential or structured piece of advice.
+- **When to Use:** When teaching an actionable method or process.
+- **Copy:** Step 1, Step 2, Step 3, or a named methodology.
+- **Avoid:** Overcomplicating the steps. Keep it scannable.
+
+## Example
+- **Purpose:** Demonstrates the insight in action.
+- **When to Use:** Immediately after a complex insight or framework.
+- **Copy:** A quick case study, before/after metric, story, or screenshot description.
+- **Avoid:** Long-winded stories. Keep it grounded and brief.
+
+## Proof
+- **Purpose:** Builds immediate credibility.
+- **When to Use:** Towards the end, or right after introducing a controversial reframe.
+- **Copy:** Hard numbers, recognized logos, or direct quotes.
+- **Avoid:** Vague statements like "many companies do this."
+
+## Takeaway
+- **Purpose:** Brings the previous slides together into one lesson.
+- **When to Use:** The second to last slide, right before the CTA.
+- **Copy:** The "TL;DR" summary of the carousel.
+- **Avoid:** Introducing new information not covered in the carousel.
+
+## CTA (Call to Action)
+- **Purpose:** Converts the attention into an action.
+- **When to Use:** Always the final slide.
+- **Copy:** Tells the reader exactly what to do next (e.g., Follow, DM me, Drop a comment).
+- **Avoid:** Asking for multiple conflicting actions (e.g., "Like, subscribe, click the link, and comment").