illyism/seo-skills

blog-refresher

Refresh and improve existing blog posts to outrank competitors using a 6-phase content audit and SERP gap analysis.

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/illyism/seo-skills --skill blog-refresher

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

Blog Refresher

You update existing blog posts so they outrank the pages above them. Analyze the post, compare it with the top-ranking competitors, find the gaps, and write an improved version that keeps the original voice.

Use real research tools: web search or a SERP API for rankings, and a page fetcher for competitor content. Do not rely on memory for what ranks or what competitors say. Use today's date for anything time-sensitive.

Keep messages short and actionable until the final refreshed content.

The 6-phase framework

  1. Current state analysis: assess the existing post
  2. Competitor research: analyze the top 5–10 SERP results
  3. Gap identification: what competitors have that the post lacks
  4. Improvement plan: a structured upgrade strategy
  5. Approval checkpoint: present findings and wait for approval
  6. Content recreation: write the refreshed version

Phase 1: Current state analysis

Content audit checklist

BASIC METRICS
□ Word count
□ Last updated
□ Current ranking for the main keyword (if Search Console or rank data exists)
□ Page traffic per month (if analytics exists)

STRUCTURE
□ Number of H2s and H3s
□ Lists, tables, images, media
□ Internal and external links

QUALITY
□ Readability (grade level)
□ Content depth: shallow / medium / deep
□ Unique insights
□ CTAs present

Initial assessment

EXISTING POST ANALYSIS
Title:
URL:
Primary keyword:

STRENGTHS: what works, unique angles, strong sections to keep
WEAKNESSES: outdated information, missing topics, weak sections, poor flow
QUICK WINS: easy updates, stats to refresh, broken links to fix

Phase 2: Competitor research

Step 1: Read the SERP

Extract the top 10 titles, the featured snippet, People Also Ask questions, related searches, and the dominant content format.

Step 2: Pick 5 competitors

Prioritize direct competitors, pages ranking #1–3, recently updated content, and pages with visible engagement.

Step 3: Audit each competitor page

URL / Ranking position
Word count
H2 sections and H3 breakdown
Unique elements: features, data, examples, visuals, interactive tools
Last modified date

Phase 3: Gap analysis

Build a table that compares the post with each competitor:

ElementYour postComp 1Comp 2Comp 3Comp 4Comp 5Priority
Word count
Featured snippet format
[Topic 1]
[Topic 2]
Statistics / data
Examples / cases
Visuals
FAQ section
Schema markup

Then list missing topics by priority:

  • High: covered by 4+ competitors
  • Medium: covered by 2–3 competitors
  • Low: covered by 1 competitor
  • Emerging: angles nobody covers yet

Finish with each competitor's unique angle and the post's opportunity to differentiate.

Phase 4: Refresh strategy

IMMEDIATE
□ Update outdated statistics to the latest available data
□ Fix broken links
□ Add missing high-priority topics
□ Format the answer for the featured snippet
□ Refresh examples and screenshots

STRUCTURE
□ Reorder H2s for better flow
□ Add an FAQ from People Also Ask
□ Add comparison tables
□ Improve the intro hook

OPTIMIZATION
□ Target word count
□ Internal links to add
□ Authoritative external sources to cite
□ Image alt text
□ Schema markup

Proposed outline

  • 3 new title options (current year or new angle, snippet-focused, differentiated)
  • The new H2 structure, each marked Keep / Modified / New with what changes
  • Target word count and new elements (table, FAQ, diagram)

Phase 5: Approval

Present the plan before writing:

markdown
## Content refresh plan: [Post title]

### Summary
The post ranks #[X] and has fallen behind on [areas]. This refresh adds [N] sections and updates [N] outdated elements.

### Key findings
1. Content depth: competitors average [X] words vs [Y]
2. Missing topics: [top 3 gaps]
3. Outdated elements: [main issues]
4. Opportunity: [unique angle]

### Gap table
### New outline

Shall I write the refreshed version? Any sections to prioritize?

Do not promise specific ranking or traffic gains.

Phase 6: Writing the refresh

Keep what works

  • Sections that already rank well
  • The original voice and tone
  • The URL (or plan a 301 redirect)
  • Existing anchors that other pages link to

Improve

  • Add a visible "Last updated: [date]"
  • Cite the year next to every statistic
  • Go deeper than competitors on the topics that matter
  • Add original data, examples, or diagrams competitors lack

Make it scannable

  • Paragraphs of 2–3 sentences
  • More H3s
  • Lists and tables where they help
  • Jump links for long posts

SEO checklist

□ Title tag 50–60 characters
□ Meta description 150–160 characters
□ Primary keyword in the first 100 words
□ Related terms used naturally
□ Snippet-ready answer near the top
□ FAQ answers People Also Ask
□ Internal links to and from related posts

Output format

markdown
# [New title]

_Last updated: [date]_

[New intro]

[Jump links]

[Refreshed sections]

## Frequently asked questions

## Conclusion

---

### Refresh summary for the publisher
- Meta description: [new]
- Schema: [types to add]
- Internal links: [pages to link]
- Images needed: [list]
- URL: [keep / redirect plan]
- Word count: [old] → [new]
- Sections added: [list]

Quality check

  • Every gap from Phase 3 is addressed or consciously skipped
  • All data and examples are current and sourced
  • The original voice is intact
  • No keyword stuffing
  • The post gives more practical value than each competitor analyzed
같은 저장소의 Skills

더 많은 Skills

모든 Skills
illyism
커뮤니티

blitz-seo

Runs a focused 30-day SEO sprint that concentrates search-intent alignment, internal link equity, first-hand proof, and targeted backlinks onto a single money page to push it into the Top 3. Use when a high-value page is stuck on Page 2, the user mentions "blitz seo" or a 30-day SEO sprint, or SEO effort is spread too thin across dozens of URLs.

1시간 설치 수
3
GitHub Stars
1.8천
업데이트
11월 20일
illyism
커뮤니티

internal-linking

Runs reverse internal linking ("traffic-to-money routing") in the user's repo, editing high-traffic informational posts in place to pass contextual links and prefilled tool callouts to /pricing, /use-cases/, /vs/, and /tools/, and ships a before/after inbound-link table. Use when the user asks about internal linking, orphan pages, a blog that gets traffic but no signups, link equity, topic clusters, or why money pages don't rank.

1시간 설치 수
3
GitHub Stars
1.8천
업데이트
11월 20일
illyism
커뮤니티

proof-kb

Build and maintain an atomic First-Hand Proof Knowledge Base (seo/kb/) inside a repository, draft or upgrade pages with Consensus + Proof Card architecture, and propagate new benchmarks or facts across every matching page via route-fact. Use when scaffolding seo/kb/, extracting founder proof from transcripts or interviews, upgrading thin SEO posts with real receipts, or routing a new benchmark, customer win, or pricing change across multiple pages.

1시간 설치 수
3
GitHub Stars
1.8천
업데이트
11월 20일
illyism
커뮤니티

seo-roast

Runs a brutal, revenue-first SEO teardown of a site and its codebase, kills fatal crawl, programmatic, layout, authority, and AI-visibility blockers in a fix PR, and ships a revenue-ordered seo/roast-roadmap.md (plus an optional client deck). Use when the user says "roast my SEO", "why don't we rank", "audit my site", "SEO teardown", asks why traffic or signups are flat, or wants an SEO review that ends in fixes instead of a checklist.

1시간 설치 수
3
GitHub Stars
1.8천
업데이트
11월 20일