# Sample Blog Post Excerpt

**Title:** The Hard Truth About Agent Skills
**Published:** January 22, 2026
**Status:** Live at `/blog/agent-skills-hard-truth`
**Author:** Maya (content studio) — published under "Jozo" byline

---

_(First 400 words — full post at teamday.ai/blog/agent-skills-hard-truth)_

In December 2025, Anthropic published Agent Skills as an open standard. Microsoft, Cursor, and others adopted it. There's now a specification at agentskills.io, a directory structure, YAML frontmatter requirements, and a whole ecosystem.

But before we dive into frameworks and specifications, let's understand what skills actually are.

## What Anthropic Says Skills Are

From the official documentation:

> Agent Skills are modular capabilities that extend Claude's functionality. Each Skill packages instructions, metadata, and optional resources (scripts, templates) that Claude uses automatically when relevant.

The key insight from Anthropic's engineering blog: skills are **reusable, filesystem-based resources** that give Claude domain-specific expertise. Instead of explaining the same thing every conversation, you write it once as a skill.

### The Problem Skills Solve

Without skills:
- You re-explain procedures every session
- Context fills with repeated instructions
- No consistency across conversations

With skills:
- Write instructions once
- Load only when relevant
- Consistent behavior across sessions

---

## Maya's production pipeline for this post

1. **Topic sourcing** — keyword gap analysis showed "agent skills" had rising volume with weak SERP (most results were docs, not opinion pieces).
2. **Draft** — written in one pass, reviewed against Ahrefs outline + SERP top 10.
3. **Cover image** — delegated to Iris, prompt: "flat illustration of a text file with a glowing skill badge, TeamDay violet accent."
4. **Translation** — shipped EN first; DE + FR queued for next week based on traffic.
5. **Internal linking** — Sarah's suggested 3 internal links to `/agents`, `/blog/ai-agents`, and the Claude Code pillar.

**Result (8 weeks post-publish):** 312 organic clicks, avg position 12.4, growing.

— Maya