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/error-handling.md

View on GitHub
# Error Handling Reference — Content Engine

> **Scope**: Recovery procedures when Phase 4 scripts fail, sources are malformed, or gate checks fail repeatedly
> **Version range**: all versions
> **Generated**: 2026-04-16

---

## Overview

The content-engine pipeline has two failure modes: artifact-level errors (source too long, no ideas extracted, platform unspecified) and gate-level errors (hype phrases detected, verbatim cross-platform sentences found, scripts unavailable). Artifact errors block forward progress and require asking the user. Gate errors require targeted rewrites, not full pipeline restarts.

---

## Pattern Catalog

### Target the Flagged Section on Gate Failure

**Detection**:
```bash
# Repeated Phase headers in session artifacts signal a full restart occurred
grep -c "## Atomic Ideas" content_ideas.md
```

**Signal**: Deleting `content_ideas.md` and `content_drafts.md` and starting over when Phase 4 flags a single hype phrase.

**Why this matters**: Gate failures are surgical — one phrase in one draft. Restarting discards clean work from passing sections. The gate exists to target the failure, not trigger a full rewrite.

**Preferred action**: Identify the flagged section, rewrite only that sentence, re-run the script. Preserve all sections that passed.

---

### Always Run Script Gates Before Advancing

**Detection**:
```bash
# Check if drafts were ever run through the gate (status field should say READY)
grep "Status:" content_drafts.md
# "DRAFT — pending Phase 4 gate" means gate was never run
```

**Signal**: "I've reviewed the drafts carefully and they look clean. Proceeding to Phase 5."

**Why this matters**: Self-assessment misses hype phrases embedded in context and cannot reliably detect verbatim cross-platform sentences. The scripts use exact string matching; LLMs use paraphrase matching — these produce different results.

**Preferred action**: Always run both script checks before Phase 5. If scripts are unavailable, use the manual fallback procedures below — do not skip the check.

---

### Confirm Target Platforms Before Drafting

**Detection**:
```bash
# Generic platform headers in drafts suggest unprompted multi-platform production
grep -cE "^## (X|LinkedIn|TikTok|YouTube|Newsletter)" content_drafts.md
# If count > platforms user asked for, drafts were overproduced
```

**Signal**: User says "make some social posts" with no platform specified; skill produces drafts for X, LinkedIn, TikTok, and Newsletter simultaneously without asking.

**Why this matters**: Each platform requires distinct register, length, and hook style. Producing all platforms without platform-specific intent produces content that fits none of them natively. It also creates ambiguity downstream about which drafts to actually publish.

**Preferred action**: Stop at Phase 1 gate. Ask: "Which platforms — X, LinkedIn, TikTok, YouTube, newsletter, or a subset?" Proceed only after the target is confirmed.

---

### Rewrite from the Atomic Idea for Each Platform

**Detection**:
```bash
# Find sentences that appear verbatim across platform sections
grep -v "^#\|^---\|^$\|^Status:\|^Generated:\|^Primary" content_drafts.md | sort | uniq -d
```

**Signal**: LinkedIn draft opens with "We cut deploy time by 80%. Here's what changed." X thread also opens with "We cut deploy time by 80%. Here's what changed." Rewrite swaps "Here's" to "This is".

**Why this matters**: Synonym swaps preserve the same sentence structure, register, and cadence. A LinkedIn hook and an X hook serve different scroll-stopping functions and cannot share a sentence in any form — cross-platform readers notice the register mismatch even when words differ.

**Preferred action**: Rewrite the hook for the second platform from scratch, starting from the atomic idea (not from the other platform's draft). The two hooks should be unrecognizable as siblings.

---

## Manual Fallback Patterns (When Scripts Are Unavailable)

### Fallback for Hype Phrase Gate

When `~/private-skills/scripts/scan-negative-framing.py` is unavailable:

```bash
# Run exact-match scan manually against content_drafts.md (case-insensitive)
grep -in \
  "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" content_drafts.md
```

Each match is a hard rejection — do not soften or rephrase around the phrase. Replace the entire sentence with a specific result, number, counterintuitive claim, or observation.

```bash
# Verify clean after rewrite (should return no output)
grep -in "game-changing\|revolutionary\|transformative\|disruptive\|synergy\|leverage" content_drafts.md
```

Note in the Phase 5 delivery output that the automated gate was unavailable and manual fallback was used.

### Fallback for Cross-Platform Verbatim Gate

When `~/private-skills/scripts/scan-negative-framing.py` is unavailable for cross-platform checks:

```bash
# Find lines appearing in two or more platform sections
grep -v "^#\|^---\|^$\|^Status:\|^Generated:\|^Primary\|^Subject" content_drafts.md \
  | sort | uniq -d
```

Non-empty output means a sentence appears verbatim in multiple platform sections. Rewrite it in one platform with platform-native register — not a synonym swap. Re-run the command to verify clean.

---

## Error-Fix Mappings

| Error | Root Cause | Fix |
|-------|------------|-----|
| `scan-negative-framing.py: No such file` | Script lives in `~/private-skills/scripts/` | Run `python3 ~/private-skills/scripts/scan-negative-framing.py content_drafts.md`; if missing use manual `grep -in` fallback |
| Gate never exits 0 after 3 rewrites | Hype phrase is inside a quoted source block or attribution | Remove or rephrase the quoted material itself |
| `content_drafts.md: No such file or directory` | Phase 3 artifact was not saved before Phase 4 | Return to Phase 3, save the file, then re-run Phase 4 |
| Script exits 0 but delivery has hype phrase | Phrase was added in post-gate LLM edits | Re-run script after any edits made after the gate passed |
| Source yields 0 atomic ideas | Source is a URL, title, or one-sentence fragment without substance | Ask user for the full source content before proceeding |
| `content_ideas.md` has 1 idea but 5 platforms requested | Narrow source asset can't support multi-platform variation | Produce the strongest single-platform draft; offer others as optional in Phase 5 |
| Verbatim check flags subject line match | Newsletter subject line shares words with X hook | Subject line word matches in isolation don't fail the check — only full sentences |

---

## Detection Commands Reference

```bash
# Manual hype phrase scan (hard rejections, case-insensitive)
grep -in "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" content_drafts.md

# Find verbatim sentences shared across platform sections
grep -v "^#\|^---\|^$\|^Status:\|^Generated:\|^Primary\|^Subject" content_drafts.md | sort | uniq -d

# Check gate status (should read READY before Phase 5)
grep "Status:" content_drafts.md

# Find unresolved placeholders before delivery
grep -E "\[URL\]|\[handle\]|\[date\]|\[title\]|\[name\]" content_drafts.md

# Verify content_ideas.md exists and has numbered ideas
grep -cE "^[0-9]+\." content_ideas.md 2>/dev/null || echo "ERROR: content_ideas.md missing or has no numbered ideas"

# Confirm expected platform sections exist in drafts
grep -E "^## (X|LinkedIn|TikTok|YouTube|Newsletter)" content_drafts.md
```

---

## See Also

- `references/phase-playbook.md` — Source-level error cases (source too long, fewer than 3 ideas, ambiguous source)
- `references/platform-specs.md` — Character limits and format constraints that trigger revision needs
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