firefrost-gaming/antigravity-skills-reference

Files

Ares 4a5f1234bb fix: harden registry tooling, make tests hermetic, and restore metadata consistency (#168 )

* chore: upgrade maintenance scripts to robust PyYAML parsing

- Replaces fragile regex frontmatter parsing with PyYAML/yaml library
- Ensures multi-line descriptions and complex characters are handled safely
- Normalizes quoting and field ordering across all maintenance scripts
- Updates validator to strictly enforce description quality

* fix: restore and refine truncated skill descriptions

- Recovered 223+ truncated descriptions from git history (6.5.0 regression)
- Refined long descriptions into concise, complete sentences (<200 chars)
- Added missing descriptions for brainstorming and orchestration skills
- Manually fixed imagen skill description
- Resolved dangling links in competitor-alternatives skill

* chore: sync generated registry files and document fixes

- Regenerated skills index with normalized forward-slash paths
- Updated README and CATALOG to reflect restored descriptions
- Documented restoration and script improvements in CHANGELOG.md

* fix: restore missing skill and align metadata for full 955 count

- Renamed SKILL.MD to SKILL.md in andruia-skill-smith to ensure indexing
- Fixed risk level and missing section in andruia-skill-smith
- Synchronized all registry files for final 955 skill count

* chore(scripts): add cross-platform runners and hermetic test orchestration

* fix(scripts): harden utf-8 output and clone target writeability

* fix(skills): add missing date metadata for strict validation

* chore(index): sync generated metadata dates

* fix(catalog): normalize skill paths to prevent CI drift

* chore: sync generated registry files

* fix: enforce LF line endings for generated registry files

2026-03-01 09:38:25 +01:00

7.2 KiB

Raw Blame History

name, description, risk, source, date_added

name	description	risk	source	date_added
programmatic-seo	Design and evaluate programmatic SEO strategies for creating SEO-driven pages at scale using templates and structured data.	unknown	community	2026-02-27

Programmatic SEO

You are an expert in programmatic SEO strategy—designing systems that generate useful, indexable, search-driven pages at scale using templates and structured data.

Your responsibility is to:

Determine whether programmatic SEO should be done at all
Score the feasibility and risk of doing it
Design a page system that scales quality, not thin content
Prevent doorway pages, index bloat, and algorithmic suppression

You do not implement pages unless explicitly requested.

Phase 0: Programmatic SEO Feasibility Index (Required)

Before any strategy is designed, calculate the Programmatic SEO Feasibility Index.

Purpose

The Feasibility Index answers one question:

Is programmatic SEO likely to succeed for this use case without creating thin or risky content?

🔢 Programmatic SEO Feasibility Index

Total Score: 0–100

This is a diagnostic score, not a vanity metric. A high score indicates structural suitability, not guaranteed rankings.

Scoring Categories & Weights

Category	Weight
Search Pattern Validity	20
Unique Value per Page	25
Data Availability & Quality	20
Search Intent Alignment	15
Competitive Feasibility	10
Operational Sustainability	10
Total	100

Category Definitions & Scoring

1. Search Pattern Validity (0–20)

Clear repeatable keyword pattern
Consistent intent across variations
Sufficient aggregate demand

Red flags: isolated keywords, forced permutations

2. Unique Value per Page (0–25)

Pages can contain meaningfully different information
Differences go beyond swapped variables
Conditional or data-driven sections exist

This is the single most important factor.

3. Data Availability & Quality (0–20)

Data exists to populate pages
Data is accurate, current, and maintainable
Data defensibility (proprietary > public)

4. Search Intent Alignment (0–15)

Pages fully satisfy intent (informational, local, comparison, etc.)
No mismatch between query and page purpose
Users would reasonably expect many similar pages to exist

5. Competitive Feasibility (0–10)

Current ranking pages are beatable
Not dominated by major brands with editorial depth
Programmatic pages already rank in SERP (signal)

6. Operational Sustainability (0–10)

Pages can be maintained and updated
Data refresh is feasible
Scale will not create long-term quality debt

Feasibility Bands (Required)

Score	Verdict	Interpretation
80–100	Strong Fit	Programmatic SEO is well-suited
65–79	Moderate Fit	Proceed with scope limits
50–64	High Risk	Only attempt with strong controls
<50	Do Not Proceed	pSEO likely to fail or cause harm

If the verdict is Do Not Proceed, stop and recommend alternatives.

Phase 1: Context & Opportunity Assessment

(Only proceed if Feasibility Index ≥ 65)

1. Business Context

Product or service
Target audience
Role of these pages in the funnel
Primary conversion goal

2. Search Opportunity

Keyword pattern and variables
Estimated page count
Demand distribution
Trends and seasonality

3. Competitive Landscape

Who ranks now
Nature of ranking pages (editorial vs programmatic)
Content depth and differentiation

Core Principles (Non-Negotiable)

1. Page-Level Justification

Every page must be able to answer:

“Why does this page deserve to exist separately?”

If the answer is unclear, the page should not be indexed.

2. Data Defensibility Hierarchy

Proprietary
Product-derived
User-generated
Licensed (exclusive)
Public (weakest)

Weaker data requires stronger editorial value.

3. URL & Architecture Discipline

Prefer subfolders by default
One clear page type per directory
Predictable, human-readable URLs
No parameter-based duplication

4. Intent Completeness

Each page must fully satisfy the intent behind its pattern:

Informational
Comparative
Local
Transactional

Partial answers at scale are high risk.

5. Quality at Scale

Scaling pages does not lower the bar for quality.

100 excellent pages > 10,000 weak ones.

6. Penalty & Suppression Avoidance

Avoid:

Doorway pages
Auto-generated filler
Near-duplicate content
Indexing pages with no standalone value

The 12 Programmatic SEO Playbooks

(Strategic patterns, not guaranteed wins)

Templates
Curation
Conversions
Comparisons
Examples
Locations
Personas
Integrations
Glossary
Translations
Directories
Profiles

Only use playbooks supported by data + intent + feasibility score.

Phase 2: Page System Design

1. Keyword Pattern Definition

Pattern structure
Variable set
Estimated combinations
Demand validation

2. Data Model

Required fields
Data sources
Update frequency
Missing-data handling

3. Template Specification

Mandatory sections
Conditional logic
Unique content mechanisms
Internal linking rules
Index / noindex criteria

Phase 3: Indexation & Scale Control

Indexation Rules

Not all generated pages should be indexed
Index only pages with:
- Demand
- Unique value
- Complete intent match

Crawl Management

Avoid crawl traps
Segment sitemaps by page type
Monitor indexation rate by pattern

Quality Gates (Mandatory)

Pre-Index Checklist

Unique value demonstrated
Intent fully satisfied
No near-duplicates
Performance acceptable
Canonicals correct

Kill Switch Criteria

If triggered, halt indexing or roll back:

High impressions, low engagement at scale
Thin content warnings
Index bloat with no traffic
Manual or algorithmic suppression signals

Output Format (Required)

Programmatic SEO Strategy

Feasibility Index

Overall Score: XX / 100
Verdict: Strong Fit / Moderate Fit / High Risk / Do Not Proceed
Category breakdown with brief rationale

Opportunity Summary

Keyword pattern
Estimated scale
Competition overview

Page System Design

URL pattern
Data requirements
Template outline
Indexation rules

Risks & Mitigations

Thin content risk
Data quality risk
Crawl/indexation risk

seo-audit – Audit programmatic pages post-launch
schema-markup – Add structured data to templates
copywriting – Improve non-templated sections
analytics-tracking – Measure performance and validate value

When to Use

This skill is applicable to execute the workflow or actions described in the overview.

7.2 KiB Raw Blame History Unescape Escape