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/seo-guidelines.md

View on GitHub
# SEO Guidelines Reference

## Length Requirements

### Title Tag
| Status | Character Count |
|--------|-----------------|
| Too short | < 30 chars |
| Suboptimal | 30-49 chars |
| Optimal | 50-60 chars |
| Too long | > 60 chars (truncated in SERPs) |

**Why it matters**: Search engines display ~60 characters in results. Truncated titles lose impact and may cut off key information.

### Meta Description
| Status | Character Count |
|--------|-----------------|
| Too short | < 120 chars |
| Suboptimal | 120-149 chars |
| Optimal | 150-160 chars |
| Too long | > 160 chars (truncated in SERPs) |

**Why it matters**: Descriptions are the "sales pitch" in search results. Too short wastes opportunity; too long gets cut off.

### URL Slug
| Status | Character Count |
|--------|-----------------|
| Optimal | 3-5 words |
| Acceptable | Up to 75 chars |
| Too long | > 75 chars |

**Why it matters**: Short, descriptive URLs are easier to share and may rank slightly better.

---

## Keyword Density

### Target Ranges
| Density | Assessment |
|---------|------------|
| 0-0.5% | Too low - keyword may not be recognized |
| 0.5-1% | Acceptable - natural usage |
| 1-2% | Optimal - good balance |
| 2-2.5% | Borderline - review for naturalness |
| 2.5-3% | Warning - likely over-optimized |
| > 3% | Critical - keyword stuffing territory |

### Calculation
```
Keyword Density = (Number of keyword occurrences / Total word count) * 100
```

### Counting Rules
- Count exact phrase matches: "hugo debugging" = 1 occurrence
- Partial matches don't count: "hugo" alone or "debugging" alone
- Variations count separately: "debug hugo" vs "hugo debugging"
- Headers count same as body text
- Alt text on images counts

---

## Header Hierarchy Best Practices

### Structure Rules
1. **H1**: Title only - exactly one per page
2. **H2**: Main sections - 3-7 is typical for blog posts
3. **H3**: Subsections within H2s
4. **H4+**: Rarely needed, use sparingly

### Common Mistakes
| Issue | Problem | Fix |
|-------|---------|-----|
| Multiple H1s | Confuses document structure | Use H2 for sections |
| Skipping levels | H1 -> H3 breaks hierarchy | Add H2 between |
| Too many H2s | Dilutes importance | Consolidate sections |
| No H2s | No clear structure | Add section headers |

### Keyword in Headers
- Primary keyword should appear in 1-2 H2s naturally
- Place keywords in headers where they fit naturally
- Variations are fine: "Debugging Hugo" vs "Hugo Debugging"

---

## Content Structure

### First Paragraph Requirements
- Should contain primary keyword within first 100 words
- Should establish what problem/topic the post addresses
- Should give reader reason to continue

### Ideal Blog Post Structure
```
Title (H1) - contains primary keyword
Introduction - primary keyword in first 100 words
Section 1 (H2) - optionally contains keyword
  Content with natural keyword usage
  Subsection (H3) if needed
Section 2 (H2) - primary keyword variation
  Content
Section 3 (H2)
  Content
Conclusion (H2)
  Summary, call to action, internal links
```

---

## Internal Linking Best Practices

### Link Quantity
| Post Length | Recommended Links |
|-------------|-------------------|
| < 500 words | 1-2 internal links |
| 500-1500 words | 2-4 internal links |
| 1500-3000 words | 4-6 internal links |
| > 3000 words | 6-10 internal links |

### Anchor Text Rules
| Type | Example | Quality |
|------|---------|---------|
| Descriptive | "Hugo template debugging guide" | Best |
| Keyword-based | "debugging Hugo templates" | Good |
| Contextual | "I covered this in a previous post" | Acceptable |
| Generic | "click here", "read more" | Replace with descriptive anchor text |
| Naked URL | "https://example.com/post" | Replace with descriptive anchor text |

### Orphan Pages
- Every post should have at least one inbound internal link
- Posts with zero inbound links are "orphans"
- Orphans may not be discovered by search engines crawling the site

---

## Hugo/PaperMod Specifics

### Front Matter Fields for SEO
```yaml
---
title: "Primary Keyword: Descriptive Subtitle"  # H1, appears in browser tab
date: 2024-12-24
description: "150-160 char meta description with primary keyword"
summary: "Short summary for list views (can match description)"
tags: ["keyword1", "keyword2"]
keywords: ["optional", "additional", "keywords"]
---
```

### PaperMod-Specific
- `summary`: Shows on list pages, home page
- `description`: Used for meta description in head
- If only `summary` is set, PaperMod may use it for both
- Set both for full control

### URL Structure
- Hugo creates URLs from filename by default
- `content/posts/2024-12-hugo-debugging.md` -> `/posts/2024-12-hugo-debugging/`
- Use lowercase, hyphens, include keyword in slug

---

## Technical Blog SEO Considerations

### What Works for Technical Content
- Specific, problem-focused titles ("Fix Hugo Build Error X")
- Code examples (searchable, shareable)
- Error messages as headers (people search exact errors)
- Version numbers when relevant ("Hugo 0.120+")
- Comparison posts ("X vs Y")

### Preferred Alternatives
- Use specific, problem-focused titles ("Fix Hugo Build Error X")
- Explain jargon when it is necessary
- Add date context when information changes over time
- Make the title match the content it leads to
- Keep language clear and aligned with the technical brand

### Long-Tail Keywords
Technical blogs often rank for long-tail keywords:
- "hugo template not found error" (specific error)
- "hugo partial not rendering" (specific symptom)
- "migrate from jekyll to hugo" (specific task)

These are often more valuable than generic terms like "hugo tutorial".
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