Skill Grading Report: create-viral-content - Score 88/100 (B)

[RichardHightower]

✅ Skill Grading Report

Score: 88/100 | Grade: B

Quick Summary

Pillar Scores

Pillar	Score	Max
Spec Compliance	15	15
Progressive Disclosure	24	30
Ease of Use	21	25
Writing Style	7	10
Utility	18	20
Modifiers	+3	±15

Issues Found: 5

• 🔴 High: 0
• 🟡 Medium: 3
• 🟢 Low: 2

📊 Full Grading Report

Skill Evaluation: create-viral-content

Score: 88/100 (B)
Repository: aaaronmiller/create-viral-content

What's Going On With This Skill?

create-viral-content scores 88/100 (B). It works, but there are a few things holding it back from being great.

The Main Issues

Missing TOC in 400+ line SKILL.md (Medium priority)

SKILL.md exceeds 100 lines but lacks table of contents for navigation

Fix: Add ## Table of Contents with anchor links to major sections after metadata block

No numbered primary workflow (Medium priority)

Core Principle section describes loop but not as numbered actionable steps

Fix: Convert Core Principle to explicit numbered workflow: 1. Generate draft 2. Apply platform template 3. Run refinement passes 4. Score against threshold...

Second-person voice inconsistency (Low priority)

Uses 'your posts' and 'you attack' instead of imperative form

Fix: 'Make posts spread', 'Attack it' - imperative voice throughout

Redundant content between SKILL.md and resources (Low priority)

AI Tell Detection section duplicates content available in resources/ai-tells.md

Fix: Trim SKILL.md to top-5 AI tells with 'See resources/ai-tells.md for complete catalog'

Resources directory mislabeled in SKILL.md (Medium priority)

SKILL.md references 'resources/' directory but warning says 'Review all files in the resources/ directory' without listing them

Fix: Add explicit resource file list with one-line descriptions: ai-tells.md (130+ patterns), platform-templates.md (8 platforms), etc.

Learn More

These recommendations follow Anthropic's Skill Authoring Best Practices. The key insight: Claude picks your skill from 100+ options based on the description alone—so clarity and specificity matter more than you'd expect.

Improvement Checklist

• Missing TOC in 400+ line SKILL.md (+2 points)
• No numbered primary workflow (+2 points)
• Second-person voice inconsistency (+1 points)
• Redundant content between SKILL.md and resources (+2 points)
• Resources directory mislabeled in SKILL.md (+1 points)

---

See Skill Authoring Best Practices for guidance.

---

📦 Recommended: Add Universal Installer Instructions

Consider adding these installation instructions to your README.md to help users install this skill across 14+ AI coding agents:

## Use This Skill with Other AI Agents

Ever run out of Claude Code tokens mid-project? Or want to try Gemini CLI or Cursor on a task?

This skill follows the [Agent Skills Standard](https://agentskills.io/), which means you can use it with **14+ AI coding agents**—not just Claude Code. The `skilz` CLI makes this easy.

### Quick Install

```bash
pip install skilz

# Install for Claude Code (your home directory)
skilz install -g https://github.com/aaaronmiller/create-viral-content

# Or from the SkillzWave marketplace
skilz install aaaronmiller_create-viral-content/create-viral-content

That's it. The skill is now available in all your Claude Code projects.

Using with Other Agents

Switch agents with --agent:

# Gemini CLI
skilz install -g https://github.com/aaaronmiller/create-viral-content --agent gemini

# OpenCode
skilz install -g https://github.com/aaaronmiller/create-viral-content --agent opencode

# OpenAI Codex
skilz install -g https://github.com/aaaronmiller/create-viral-content --agent codex

Project-Level Install

Want the skill only in your current project? Add --project:

skilz install -g https://github.com/aaaronmiller/create-viral-content --project

Full Platform List

Skilz supports Claude Code, Gemini CLI, OpenCode, OpenAI Codex, Cursor, Windsurf, GitHub Copilot CLI, Qwen Code, Aidr, and more.

See the skill on SkillzWave for agent-specific install commands, or check the skilz-cli docs.

---

SkillzWave is a skill marketplace for AI agents. SpillWave (where I work) builds AI agent tools.

---

**Powered by:** [SkillzWave.ai](https://skillzwave.ai) | [SpillWave](https://spillwave.com)

[rickHasSkilz]

All you skills did well and were added to the market place. You did an excellent job writing them. Thank you.