Skip to content

notque/vexjoy-agent / skills/content/content

content

Unverified

Content operations: editorial calendar, marketing, publishing, social media management.

FileKindSize
SKILL.mdskill md11.5 KB
references/at-protocol-api.mdmarkdown7.6 KB
references/at-protocol-preferred-patterns.mdmarkdown8.5 KB
references/batch-edit-examples.mdmarkdown6.9 KB
references/batch-edit-operation-types.mdmarkdown7.0 KB
references/batch-edit-regex-patterns.mdmarkdown5.4 KB
references/batch-edit-safety-checklist.mdmarkdown6.0 KB
references/batch-edit.mdmarkdown9.9 KB
references/calendar-format.mdmarkdown3.5 KB
references/campaign-planning.mdmarkdown17.5 KB
references/classification-prompt.mdmarkdown5.9 KB
references/content-engine.mdmarkdown8.7 KB
references/content-engine/error-handling.mdmarkdown7.8 KB
references/content-engine/phase-playbook.mdmarkdown8.3 KB
references/content-engine/platform-specs.mdmarkdown10.9 KB
references/content-strategy.mdmarkdown14.5 KB
references/email-sequences.mdmarkdown15.8 KB
references/error-handling.mdmarkdown8.2 KB
references/headlines.mdmarkdown5.9 KB
references/image-audit-alt-text-examples.mdmarkdown6.8 KB
references/image-audit-format-selection.mdmarkdown5.8 KB
references/image-audit-report-templates.mdmarkdown3.8 KB
references/image-audit-size-guidelines.mdmarkdown4.2 KB
references/image-audit.mdmarkdown10.4 KB
references/link-audit-false-positives.mdmarkdown4.1 KB
references/link-audit-fix-strategies.mdmarkdown7.1 KB
references/link-audit-graph-metrics.mdmarkdown5.0 KB
references/link-audit.mdmarkdown7.8 KB
references/llm-marketing-failure-modes.mdmarkdown18.7 KB
references/marketing.mdmarkdown20.4 KB
references/metrics.mdmarkdown7.4 KB
references/news-collection.mdmarkdown5.2 KB
references/operations.mdmarkdown5.8 KB
references/outline-examples.mdmarkdown11.2 KB
references/outline-structure-templates.mdmarkdown6.4 KB
references/outline.mdmarkdown8.9 KB
references/pagespeed-insights.mdmarkdown10.4 KB
references/pipeline-stages.mdmarkdown3.3 KB
references/pre-publish-checklist.mdmarkdown7.4 KB
references/pre-publish-hugo-frontmatter.mdmarkdown5.3 KB
references/pre-publish-seo-guidelines.mdmarkdown4.1 KB
references/pre-publish.mdmarkdown10.8 KB
references/reddit-moderate.mdmarkdown7.9 KB
references/script-commands.mdmarkdown3.7 KB
references/seo-audit.mdmarkdown16.4 KB
references/seo-guidelines.mdmarkdown5.5 KB
references/seo-keyword-placement.mdmarkdown6.0 KB
references/seo-title-patterns.mdmarkdown5.6 KB
references/seo.mdmarkdown8.9 KB
references/series-planner.mdmarkdown11.7 KB
references/series-planner/cadence-guidelines.mdmarkdown6.8 KB
references/series-planner/cross-linking.mdmarkdown7.2 KB
references/series-planner/output-format.mdmarkdown3.8 KB
references/series-planner/series-types.mdmarkdown7.6 KB
references/taxonomy-audit-report-format.mdmarkdown3.2 KB
references/taxonomy-consolidation-rules.mdmarkdown6.7 KB
references/taxonomy-examples.mdmarkdown9.7 KB
references/taxonomy-guidelines.mdmarkdown5.5 KB
references/taxonomy.mdmarkdown9.0 KB
references/topic-brainstormer.mdmarkdown10.1 KB
references/topic-brainstormer/content-filter.mdmarkdown7.1 KB
references/topic-brainstormer/priority-scoring.mdmarkdown8.1 KB
references/topic-brainstormer/topic-sources.mdmarkdown7.6 KB
references/wordpress-upload.mdmarkdown11.2 KB
references/x-api.mdmarkdown7.8 KB
scripts/publish/link_scanner.pyscript21.4 KB
scripts/publish/pagespeed.pyscript15.3 KB
scripts/publish/tests/test_load_env_file.pyscript3.8 KB
scripts/publish/tests/test_wordpress_inline_urls.pyscript4.4 KB
scripts/publish/tests/test_wordpress_media_upload.pyscript1.5 KB
scripts/publish/tests/test_wordpress_scraper.pyscript4.1 KB
scripts/publish/wordpress-edit-post.pyscript21.2 KB
scripts/publish/wordpress-media-upload.pyscript8.7 KB
scripts/publish/wordpress-scraper.pyscript23.4 KB
scripts/publish/wordpress-upload.pyscript44.2 KB
scripts/reddit-moderate/reddit-automod-cron.shscript3.9 KB
scripts/reddit-moderate/reddit-mod.pyscript83.0 KB
scripts/reddit-moderate/tests/test_reddit_mod.pyscript31.3 KB

references/content-engine/phase-playbook.md

View on GitHub
# Content Engine Phase Playbook

Detailed platform rules, hype phrase enforcement list, template files, delivery handoff, and error handling. Load when drafting variants or running quality gates.

## Phase 2: `content_ideas.md` Template

```markdown
# Content Ideas — [Source Title or Brief Description]

Generated: [date]
Source: [brief description of source asset]
Goal: [stated goal]
Audience: [stated audience]
Platforms: [target platforms]

## Atomic Ideas

1. [One-sentence statement of idea, specific and standalone]
2. [One-sentence statement of idea]
3. [One-sentence statement of idea]
...

## Primary Idea
[Which idea leads — the strongest for the stated goal]
```

## Phase 3: `content_drafts.md` Template

```markdown
# Content Drafts — [Source Title or Brief Description]

Generated: [date]
Primary Idea: [the idea being adapted]
Status: DRAFT — pending Phase 4 gate

---

## X (Twitter)

[Draft — single tweet or numbered thread]

---

## LinkedIn

[Draft]

---

## TikTok

[Script]

---

## YouTube

[Script or description]

---

## Newsletter

Subject line options:
1. [Option]
2. [Option]
3. [Option]

[Draft]
```

## Phase 3: Platform-Specific Rules (Full Detail)

See also `references/platform-specs.md` for additional character limits and posting norms.

### X (Twitter)

- **Register**: Conversational, direct, opinionated. No corporate voice.
- **Hook**: Open fast. The first tweet carries the entire weight — if it doesn't stop the scroll, the thread dies.
- **Structure for single tweet**: One idea, one sharp claim, optionally one proof point. End with a question or strong assertion, not a CTA.
- **Structure for thread**: Each tweet carries one thought. Segment at natural breaks. Number tweets only if >=5. No cliffhanger tweets that require the next to make sense.
- **Character limit**: 280 per tweet, hard limit. Each tweet must carry exactly one thought — do not split mid-sentence across tweets without a natural break.
- **Hashtags**: 0-2 maximum. Only if they add discoverability, never for decoration.
- **Links**: One link only, at the end of the last tweet if needed. Not in the middle of a thread.
- **CTAs**: Optional. If present, one sentence, at the end, low pressure. Do not reuse the same CTA text used in other platform drafts.

### LinkedIn

- **Register**: Professional but human. Not corporate. Lessons and results framing over announcement framing.
- **Hook**: First line must work standalone before "see more" — it is the only text visible before the fold. If the first line requires the rest of the post to land, rewrite it. It is a promise, not a topic sentence.
- **Structure**: First line → 2-4 short paragraphs of substance → optional takeaway or question at end.
- **Length**: 150-300 words optimal. Can go to 600 if the content earns it. Not longer.
- **Hashtags**: 3-5 at the end. Relevant, not decorative.
- **Links**: Put in comments, not in the post body. LinkedIn suppresses posts with external links. Reference "link in comments" if needed.
- **CTAs**: One soft CTA at end if appropriate (follow for more, drop your take in comments). Match the CTA to LinkedIn norms — "Check out the full article in the comments!" reads differently here than on X.

### TikTok

- **Format**: Short video script (voiceover or talking-head style).
- **First 3 seconds**: Show the result, state the unexpected thing, or interrupt a pattern. Never start with "In this video..." or "Today we're going to..." — preamble kills retention. This is the make-or-break moment.
- **Length**: 30-60 seconds optimal (150-300 words at speaking pace).
- **Structure**: Hook (3s) → one demonstration or explanation → punchline or twist → CTA (5s max).
- **No lists or headers in the script.** Write it to be spoken aloud.

### YouTube

- **Format**: Video script or description (specify which in the draft).
- **Show result early**: Within the first 30 seconds of script, show or state the result. Do not build to it. Same rule as TikTok for the first 3 seconds — interrupt or result, not preamble.
- **Chapter structure**: If script is >3 minutes, include chapter markers.
- **Description**: 2-3 sentences that work as search-discoverable summary, then bullet points of what the video covers, then links/CTA.
- **Thumbnail note**: Include one suggested thumbnail concept (visual + text overlay) with the draft.

### Newsletter

- **Register**: One-on-one. Write to one person, not a list.
- **Lens**: One clear angle on the idea. Not a summary — a perspective.
- **Structure**: Skimmable headers (2-4 max), short paragraphs (2-3 sentences max), one CTA at end.
- **Length**: 300-600 words. Long enough to have substance, short enough to be read.
- **Subject line**: Write 3 subject line options with the draft. Short, specific, curiosity-gap or benefit-driven.
- **No generic openers**: Do not start with "This week I want to talk about..." or "I hope this email finds you well."

---

## Phase 4: Banned Hype Phrases

This check flags banned hype phrases — they are hard rejections, not suggestions. Banned phrases include:

- "excited to share"
- "thrilled to announce"
- "game-changing"
- "revolutionary"
- "groundbreaking"
- "don't miss out"
- "limited time"
- "unlock your potential"
- "dive into"
- "leverage"
- "synergy"
- "best-in-class"
- "world-class"
- "transformative"
- "disruptive"

Opening with hype ("Excited to share our game-changing approach to...") reads as corporate noise. Replace with a specific result, number, counterintuitive claim, or observation: "We cut deploy time by 80%. Here is what actually changed."

---

## Phase 5: Delivery Details

**Delivery order**: Primary platform first (if specified), then remaining platforms alphabetically.

**For each draft, include:**
1. The draft text (from `content_drafts.md`)
2. Optimal posting time if known (platform norms: X/LinkedIn weekdays 8-10am, TikTok evenings, Newsletter Tuesday-Thursday)
3. Any remaining placeholders that must be resolved before publishing — flag clearly with what is needed to finalize (e.g., `[URL]` needs the published article link, `[handle]` needs the company X handle)
4. Suggested posting order if multiple platforms (e.g., "post X first to gauge reaction, then LinkedIn 48 hours later")

**Downstream handoff options:**

| If user wants to... | Route to |
|---------------------|----------|
| Publish to X | `x-api` skill |
| Publish to multiple platforms | `crosspost` skill |
| Schedule posts | `content-calendar` skill |
| Apply a voice profile to drafts | `writing` skill (post-process these drafts) |
| Extract more ideas from the same source | Re-run from Phase 2 |

**Optional behaviors** (off unless enabled by user):
- **Multi-idea series**: Extract all ideas and schedule as a series (pairs with `content-calendar`)
- **Voice profile application**: After drafting, apply a voice profile via `writing`
- **Immediate publish**: After gate passes, hand off to `x-api` or `crosspost`

**Artifacts produced:**
- `content_ideas.md` — numbered atomic ideas with ranking
- `content_drafts.md` — platform-native drafts, gate-verified, status: READY

---

## Error Handling

### Error: Source asset is too long to process in one pass
Cause: Article or transcript exceeds practical working length.
Solution: Ask user to identify the section to adapt, or extract section headers first and confirm which section(s) to use.

### Error: scan-negative-framing.py not found
Cause: Script lives in private-skills, not in this repo.
Solution: Run `python3 ~/private-skills/scripts/scan-negative-framing.py content_drafts.md`. If private-skills is not installed, use the manual grep fallback in `error-handling.md`.

### Error: Platform target not specified and cannot be inferred
Cause: User said "make social posts" with no platform context.
Solution: Ask. Minimum: "Which platforms — X, LinkedIn, TikTok, YouTube, newsletter, or a subset?" Do not proceed with generic drafts that are not platform-native.

### Error: Source asset is ambiguous (no clear ideas emerge)
Cause: Source is a collection of loosely related fragments.
Solution: Ask user to identify the one idea they most want to amplify. Extract around that anchor. Note that less-coherent sources produce fewer high-quality atomic ideas.

### Error: Fewer than 3 atomic ideas extracted
Cause: Source asset is very narrow or very short.
Solution: Proceed with what exists (minimum 1 idea is sufficient for a single platform). Note in `content_ideas.md` that the source yielded fewer than 3 ideas and why.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall