notque/vexjoy-agent / skills/content/content
content
UnverifiedContent operations: editorial calendar, marketing, publishing, social media management.
references/seo-title-patterns.md
View on GitHub# Title Patterns Reference
## Effective Title Structures for Technical Blogs
### Pattern 1: Problem-Solution
```
[Problem]: [Solution/Outcome]
```
**Examples**:
- "Hugo Build Failing: How to Debug Template Errors"
- "Slow Hugo Builds: Optimization Techniques That Work"
- "Missing Partials: Fixing Hugo Template Not Found Errors"
**Why it works**: Searchers often look for solutions to specific problems. This pattern signals both the problem they have and that a solution exists.
**Character target**: 45-60 chars
---
### Pattern 2: How-To Guide
```
How to [Action] [Subject] [Optional: Context]
```
**Examples**:
- "How to Debug Hugo Templates Efficiently"
- "How to Fix Hugo Shortcode Errors"
- "How to Optimize Hugo Build Performance"
**Why it works**: "How to" signals instructional content. Very searchable.
**Character target**: 35-55 chars
---
### Pattern 3: Definitive Guide
```
[Subject]: [Scope Descriptor] Guide
```
**Examples**:
- "Hugo Debugging: A Practical Troubleshooting Guide"
- "Hugo Templates: The Complete Reference"
- "Hugo Shortcodes: Developer's Guide"
**Why it works**: Signals comprehensive coverage. Attracts readers seeking depth.
**Character target**: 40-60 chars
**Warning**: Only use if content is truly comprehensive.
---
### Pattern 4: Specific Error/Scenario
```
[Exact Error/Scenario] [Fix/Explanation]
```
**Examples**:
- "Hugo 'template not found' Error: Causes and Fixes"
- "Hugo Render Hook Not Working: Debugging Steps"
- "Hugo Taxonomy Pages Missing: Quick Fix"
**Why it works**: Captures exact searches from developers with specific errors. High conversion because it matches user intent precisely.
**Character target**: 45-60 chars
---
### Pattern 5: Comparison/Versus
```
[Option A] vs [Option B]: [Context/Recommendation]
```
**Examples**:
- "Hugo Partials vs Shortcodes: When to Use Each"
- "Hugo Layouts vs Templates: Key Differences"
- "Hugo Single vs List Pages: Template Guide"
**Why it works**: Helps readers making decisions. Captures comparative searches.
**Character target**: 40-55 chars
---
### Pattern 6: Numbered List
```
[Number] [Subject] [Context/Tips]
```
**Examples**:
- "5 Hugo Debugging Techniques Every Developer Needs"
- "7 Common Hugo Errors and How to Fix Them"
- "3 Ways to Speed Up Hugo Builds"
**Why it works**: Numbers attract clicks. Signals digestible, scannable content.
**Character target**: 40-55 chars
**Warning**: Only use if content genuinely has that many distinct items.
---
### Pattern 7: Year/Version Specific
```
[Subject] [Year/Version]: [What's Changed/Covered]
```
**Examples**:
- "Hugo Debugging in 2024: Updated Techniques"
- "Hugo 0.120 Breaking Changes: Migration Guide"
- "Hugo Module System 2024: Complete Overview"
**Why it works**: Signals freshness. Captures version-specific searches.
**Character target**: 40-55 chars
**Warning**: Requires updating or risks appearing outdated.
---
## Titles That Miss the Mark
### Generic/Vague
```
BAD:
"My Hugo Experience"
"Some Thoughts on Templates"
"Hugo Stuff"
"Interesting Findings"
```
**Problem**: No keyword, no value proposition, no searchability.
### Clickbait
```
BAD:
"You Won't BELIEVE This Hugo Trick!"
"The SHOCKING Truth About Hugo Templates"
"Hugo Developers HATE This One Weird Tip"
```
**Problem**: Damages technical credibility. Readers feel misled.
### Too Long
```
BAD:
"A Comprehensive and Detailed Guide to Understanding and Debugging Hugo Static Site Generator Template Errors and Build Problems for Developers" (145 chars)
```
**Problem**: Gets truncated in search results. Dilutes keyword impact.
### Keyword Stuffed
```
BAD:
"Hugo Debugging: Debug Hugo Templates, Hugo Debug Tips"
```
**Problem**: Repetitive, spammy appearance. Hurts rankings.
### No Keyword
```
BAD:
"Solving the Mystery" (about Hugo debugging)
"The Art of Problem Solving" (about Hugo debugging)
```
**Problem**: Search engines can't match to queries. Readers don't know topic.
---
## Title Optimization Checklist
| Criteria | Check |
|----------|-------|
| Length | 50-60 characters |
| Keyword | Primary keyword included |
| Position | Keyword in first half preferred |
| Specificity | Specific > vague |
| Accuracy | Matches actual content |
| Click appeal | Reader understands value |
| Voice match | Fits YourBlog's technical tone |
---
## Generating Alternatives
When optimizing a title, generate 3 alternatives using different patterns:
**Original**: "Hugo Debugging" (14 chars - too short)
**Alternative 1** (Problem-Solution):
```
"Hugo Debugging: How to Fix Common Build Errors" (48 chars)
```
**Alternative 2** (Definitive Guide):
```
"Debugging Hugo Sites: A Practical Troubleshooting Guide" (56 chars)
```
**Alternative 3** (Specific Focus):
```
"Fix Hugo Build Errors: Practical Debugging Techniques" (54 chars)
```
Each alternative:
- Hits target length (50-60 chars)
- Contains primary keyword
- Uses different pattern
- Maintains technical tone
- Accurately reflects content
---
## YourBlog Voice Considerations
### Do Match
- Technical precision
- Problem-solving focus
- Practical over theoretical
- Direct language
- Specific outcomes
### Example Good Titles for YourBlog
```
"Debugging Hugo Race Conditions in Template Rendering"
"Why Hugo Rebuilds Everything: Understanding Dependencies"
"Hugo Shortcode Context: The Variable Scoping Gotcha"
```
### Less Suitable for YourBlog
```
"My Frustrating Journey with Hugo" <- Too personal/blog-y
"Hugo Tips and Tricks" <- Too generic
"Awesome Hugo Hacks!" <- Wrong tone
"The Ultimate Hugo Guide" <- Overpromising
```
The YourBlog brand is about the satisfaction of solving hard problems - titles should reflect the technical depth, not the emotional journey.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |