Skip to content

aiskillstore/marketplace / skills/aaron-he-zhu/rank-tracker

rank-tracker

Verified

Use when the user asks to "track rankings" or "查排名"; measures keyword and SERP-position deltas over time from provided exports or connected tools, including AI-response checks. Not for multi-metric stakeholder reports or setting alerts — use performance-monitor (report or alert mode). 排名追踪/SERP监控

FileKindSize
SKILL.mdskill md7.0 KB
references/ranking-analysis-templates.mdmarkdown4.2 KB
references/tracking-setup-guide.mdmarkdown5.1 KB
skill-report.jsonconfig23.2 KB

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-12T13:41:55.063Z",
    "slug": "aaron-he-zhu-rank-tracker",
    "source_url": "https://github.com/aaron-he-zhu/aaron-marketing-skills/tree/main/seo-geo/monitor/rank-tracker",
    "source_ref": "main",
    "model": "codex",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "ba366d8e81bcd5b012fa0cd10bab391ac80ef319583ae721337541bd88ada5ba",
    "tree_hash": "fef62a1e81daccfa8419c27e9c419ab3461b6f85ae6a57b37df6f2e1e07db915",
    "provenance": {
      "model_effective": "codex",
      "fallback_chain": [
        {
          "agent": "codex",
          "outcome": "success"
        }
      ],
      "analysis_version": "3.0.0"
    }
  },
  "skill": {
    "name": "rank-tracker",
    "description": "Tracks keyword positions, SERP features, competitor visibility, and AI citations across measured snapshots with clear source labels.",
    "summary": "Compare search ranking snapshots and turn measured changes into focused SEO actions.",
    "icon": "📦",
    "version": "16.0.2",
    "author": "aaron-he-zhu",
    "license": "Apache-2.0",
    "category": "data",
    "tags": [
      "rank-tracking",
      "seo",
      "serp-analysis",
      "competitor-monitoring",
      "ai-visibility"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "external_commands",
      "network",
      "filesystem"
    ]
  },
  "security_audit": {
    "risk_level": "safe",
    "is_blocked": false,
    "safe_to_publish": true,
    "analysis_status": "ok",
    "summary": "One medium-risk command invocation is confirmed because it directs execution of an external Python script with an unquoted domain placeholder. The other findings are false positives caused by Markdown syntax, metadata URLs, relative documentation links, and ordinary prose.",
    "remediation": [
      {
        "issue": "The ledger command passes a domain placeholder through a shell and executes a script outside this skill package.",
        "suggestion": "Use a structured process API, validate the domain, pass fixed argument arrays, and package or verify the ledger script before execution.",
        "severity": "medium"
      }
    ],
    "risk_factor_evidence": [
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 23,
            "line_end": 25
          },
          {
            "file": "SKILL.md",
            "line_start": 25,
            "line_end": 27
          },
          {
            "file": "SKILL.md",
            "line_start": 27,
            "line_end": 29
          },
          {
            "file": "SKILL.md",
            "line_start": 29,
            "line_end": 33
          },
          {
            "file": "SKILL.md",
            "line_start": 33,
            "line_end": 37
          },
          {
            "file": "SKILL.md",
            "line_start": 37,
            "line_end": 49
          },
          {
            "file": "SKILL.md",
            "line_start": 49,
            "line_end": 49
          },
          {
            "file": "SKILL.md",
            "line_start": 54,
            "line_end": 96
          }
        ]
      },
      {
        "factor": "network",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 10,
            "line_end": 10
          },
          {
            "file": "SKILL.md",
            "line_start": 14,
            "line_end": 14
          }
        ]
      },
      {
        "factor": "filesystem",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 39,
            "line_end": 39
          },
          {
            "file": "SKILL.md",
            "line_start": 43,
            "line_end": 43
          },
          {
            "file": "SKILL.md",
            "line_start": 47,
            "line_end": 47
          },
          {
            "file": "SKILL.md",
            "line_start": 49,
            "line_end": 49
          },
          {
            "file": "SKILL.md",
            "line_start": 96,
            "line_end": 96
          },
          {
            "file": "SKILL.md",
            "line_start": 104,
            "line_end": 104
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "external_commands:SKILL.md:23:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 23,
        "line_end": 25,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:25:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 25,
        "line_end": 27,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:27:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 27,
        "line_end": 29,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:29:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 29,
        "line_end": 33,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:33:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 33,
        "line_end": 37,
        "snippet": "**Expected output**: a ranking report or delta summary plus the standard handoff summary for `memory"
      },
      {
        "id": "external_commands:SKILL.md:37:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 37,
        "line_end": 49,
        "snippet": "- **Promotes**: significant changes, confirmed anomalies, follow-up actions, and pending decisions t"
      },
      {
        "id": "external_commands:SKILL.md:49:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 49,
        "line_end": 49,
        "snippet": "**Zero-dependency measurement loop** (no paid tool needed): never narrate a ranking movement you did"
      },
      {
        "id": "external_commands:SKILL.md:54:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 54,
        "line_end": 96,
        "snippet": "- No target keywords are provided and none can be inferred from `CLAUDE.md` or prior monitoring reco"
      },
      {
        "id": "network:SKILL.md:10:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 10,
        "line_end": 10,
        "snippet": "homepage: \"https://github.com/aaron-he-zhu/aaron-marketing-skills\""
      },
      {
        "id": "network:SKILL.md:14:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 14,
        "line_end": 14,
        "snippet": "metadata: {\"author\": \"aaron-he-zhu\", \"version\": \"17.0.0\", \"discipline\": \"seo-geo\", \"phase\": \"monitor"
      },
      {
        "id": "filesystem:SKILL.md:39:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 39,
        "line_end": 39,
        "snippet": "- **Primary next skill**: [performance-monitor](../performance-monitor/SKILL.md) when recurring moni"
      },
      {
        "id": "filesystem:SKILL.md:43:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 43,
        "line_end": 43,
        "snippet": "> Emit the standard shape from [skill-contract.md §Handoff Summary Format](../../../references/skill"
      },
      {
        "id": "filesystem:SKILL.md:47:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 47,
        "line_end": 47,
        "snippet": "All integrations optional (see [CONNECTORS.md](../../../CONNECTORS.md)). With tools, pull rankings f"
      },
      {
        "id": "filesystem:SKILL.md:49:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 49,
        "line_end": 49,
        "snippet": "**Zero-dependency measurement loop** (no paid tool needed): never narrate a ranking movement you did"
      },
      {
        "id": "filesystem:SKILL.md:96:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 96,
        "line_end": 96,
        "snippet": "Ask \"Save these results?\" If yes, write to `memory/monitoring/` — see [Skill Contract](../../../refe"
      },
      {
        "id": "filesystem:SKILL.md:104:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 104,
        "line_end": 104,
        "snippet": "Initial setup (no baseline) → [performance-monitor](../performance-monitor/SKILL.md). Subsequent run"
      },
      {
        "id": "blocker:SKILL.md:49:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 49,
        "line_end": 49,
        "snippet": "**Zero-dependency measurement loop** (no paid tool needed): never narrate a ranking movement you did"
      }
    ],
    "finding_verdicts": [
      {
        "id": "external_commands:SKILL.md:23:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The detected backticks open a Markdown code fence containing a prompt example. They do not invoke Ruby or a shell."
      },
      {
        "id": "external_commands:SKILL.md:25:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The detected backticks close one Markdown example and separate it from another. No command is executed."
      },
      {
        "id": "external_commands:SKILL.md:27:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The detected backticks are Markdown fencing around a natural-language prompt. They are not shell substitution syntax."
      },
      {
        "id": "external_commands:SKILL.md:29:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The line closes a Markdown code block and begins documentation. It contains no executable shell operation."
      },
      {
        "id": "external_commands:SKILL.md:33:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The backticks format the memory/monitoring path as inline code. This is documentation, not command execution."
      },
      {
        "id": "external_commands:SKILL.md:37:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The backticks format a memory file path in prose. No interpreter or command runner is invoked."
      },
      {
        "id": "external_commands:SKILL.md:49:ruby-shell-backtick-execution",
        "verdict": "confirmed",
        "confidence": 0.92,
        "reason": "The line explicitly directs execution of a Python ledger script and interpolates an unquoted domain placeholder. Shell interpretation could enable argument or command injection.",
        "severity": "medium"
      },
      {
        "id": "external_commands:SKILL.md:54:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The backticks format the CLAUDE.md filename in a decision rule. They do not execute a command."
      },
      {
        "id": "network:SKILL.md:10:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The URL is repository homepage metadata. It does not cause a network request or transmit user data."
      },
      {
        "id": "network:SKILL.md:14:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The URL appears inside author metadata as the project homepage. It is descriptive and does not initiate network activity."
      },
      {
        "id": "filesystem:SKILL.md:39:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The traversal sequence is a relative Markdown link to another skill document. It does not read or write a resolved filesystem path."
      },
      {
        "id": "filesystem:SKILL.md:43:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The sequence occurs in a relative documentation link to the handoff format. It is not user-controlled path traversal."
      },
      {
        "id": "filesystem:SKILL.md:47:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The sequence is part of a Markdown link to CONNECTORS.md. No filesystem operation uses the path."
      },
      {
        "id": "filesystem:SKILL.md:49:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The traversal syntax belongs to relative reference links in the documentation. The executable script path uses CLAUDE_PLUGIN_ROOT instead of traversal segments."
      },
      {
        "id": "filesystem:SKILL.md:96:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The traversal sequence is confined to a Markdown link to the skill contract. The documented save path is separate and requires user confirmation."
      },
      {
        "id": "filesystem:SKILL.md:104:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The sequences are relative Markdown links to neighboring documentation. They are not inputs to a file access operation."
      },
      {
        "id": "blocker:SKILL.md:49:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The line records and compares ranking data through a named ledger helper. It does not enumerate host details, credentials, processes, or network configuration."
      }
    ],
    "semantic_findings": [],
    "critical_findings": [],
    "high_findings": [],
    "medium_findings": [
      {
        "title": "Ruby/shell backtick execution",
        "description": "**Zero-dependency measurement loop** (no paid tool needed): never narrate a ranking movement you did",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 49,
            "line_end": 49
          }
        ],
        "review_kind": "capability",
        "source_category": "external_commands",
        "source_severity": "medium",
        "confidence": 0.92,
        "confidence_reasoning": "The line explicitly directs execution of a Python ledger script and interpolates an unquoted domain placeholder. Shell interpretation could enable argument or command injection."
      }
    ],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 3,
    "total_lines": 359,
    "audit_model": "codex",
    "audited_at": "2026-07-12T13:41:55.063Z",
    "agent_auto_install_policy": "allowed",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Track Search Rankings and SERP Visibility",
    "value_statement": "Ranking changes are hard to interpret without consistent baselines and source labels. This skill compares snapshots, identifies meaningful movements, and recommends focused SEO actions.",
    "seo_keywords": [
      "Claude rank tracker",
      "Codex SEO analysis",
      "Claude Code rank monitoring",
      "keyword rank tracking",
      "SERP position analysis",
      "search visibility monitoring",
      "competitor ranking comparison",
      "SERP feature tracking",
      "AI citation monitoring",
      "SEO ranking report"
    ],
    "actual_capabilities": [
      "Configures tracking by domain, keyword, market, device, language, frequency, priority, and competitor.",
      "Compares current keyword positions with a prior baseline and labels each delta.",
      "Identifies gains, declines, new rankings, lost rankings, and stable terms.",
      "Tracks featured snippets, People Also Ask, media packs, local packs, and AI Overview citations.",
      "Compares competitor positions, visibility share, and keyword-level threats.",
      "Produces ranking summaries with source labels, likely causes, and recommended actions."
    ],
    "limitations": [
      "It needs user-provided data or connected tools for measured rankings.",
      "It cannot confirm ranking causes from position changes alone.",
      "Missing SERP features or AI citation data are reported as unavailable.",
      "A first run creates a baseline and cannot report historical movement."
    ],
    "use_cases": [
      {
        "title": "Review Weekly Keyword Movement",
        "description": "Compare weekly exports, identify important gains and losses, and prioritize investigation.",
        "target_user": "SEO specialist"
      },
      {
        "title": "Monitor Competitive Search Visibility",
        "description": "Compare priority terms against direct competitors and highlight emerging threats or opportunities.",
        "target_user": "Growth marketer"
      },
      {
        "title": "Summarize Portfolio Ranking Health",
        "description": "Create a sourced ranking summary across markets, devices, SERP features, and AI citations.",
        "target_user": "Marketing manager"
      }
    ],
    "prompt_templates": [
      {
        "title": "Create a Baseline",
        "prompt": "Track rankings for [domain] using [keywords] in [market] on [device]. Label every position by source and create the first baseline.",
        "scenario": "Use when no earlier ranking snapshot exists."
      },
      {
        "title": "Compare Two Snapshots",
        "prompt": "Compare these ranking snapshots for [domain]. Show each keyword delta, biggest gains, biggest losses, new rankings, lost rankings, and next actions.",
        "scenario": "Use for a routine ranking review."
      },
      {
        "title": "Analyze SERP and AI Visibility",
        "prompt": "Analyze SERP features and AI visibility for [keywords]. Compare ownership, citations, competitors, content gaps, and source confidence. Mark unavailable metrics clearly.",
        "scenario": "Use when feature and AI monitoring data are available."
      },
      {
        "title": "Diagnose a Ranking Decline",
        "prompt": "Investigate this ranking decline using [snapshots], [competitor data], and [technical signals]. Separate measured facts from hypotheses and prioritize recovery actions by urgency.",
        "scenario": "Use for advanced root-cause assessment."
      }
    ],
    "output_examples": [
      {
        "input": "Compare the June and July ranking exports for example.com across ten priority keywords.",
        "output": [
          "Overall trend: six keywords improved, two declined, and two remained stable.",
          "Largest gain: pricing software moved from position 12 to 6, based on the provided exports.",
          "Priority action: investigate the two declining pages before changing stable content."
        ]
      },
      {
        "input": "Review our SERP feature and AI citation visibility against two competitors.",
        "output": [
          "The site owns two featured snippets while the competitor average is four.",
          "AI citation data are unavailable for three keywords and are marked accordingly.",
          "The strongest opportunity is a concise comparison section for the highest-volume uncovered query."
        ]
      }
    ],
    "best_practices": [
      "Provide dated snapshots with the same market, device, language, and search engine.",
      "Separate measured values, user-provided values, estimates, and unavailable metrics.",
      "Review large movements against competitors, technical events, and known algorithm updates."
    ],
    "anti_patterns": [
      "Do not claim movement when no prior baseline exists.",
      "Do not present inferred positions or causes as measured facts.",
      "Do not compare snapshots with different markets or devices without clear segmentation."
    ],
    "faq": [
      {
        "question": "What data does this skill need?",
        "answer": "Provide a domain, target keywords, market, device, and current positions. Add a prior snapshot to calculate movement."
      },
      {
        "question": "Can it work without a paid rank tracker?",
        "answer": "Yes. You can provide manually checked positions or exports, but each value must include a clear source label."
      },
      {
        "question": "What happens on the first run?",
        "answer": "The first run becomes the baseline. All changes remain unavailable until a later snapshot is recorded."
      },
      {
        "question": "Does it track SERP features?",
        "answer": "Yes. It can compare snippets, People Also Ask, media packs, local packs, and related ownership changes."
      },
      {
        "question": "Can it monitor AI search visibility?",
        "answer": "Yes. It reports AI Overview presence and citations when measured data exist. Missing observations remain unavailable."
      },
      {
        "question": "Can it prove why a ranking changed?",
        "answer": "No. It proposes likely causes from available signals, but ranking movement alone does not establish causation."
      }
    ]
  },
  "file_structure": [
    {
      "name": "references",
      "type": "dir",
      "path": "references",
      "children": [
        {
          "name": "ranking-analysis-templates.md",
          "type": "file",
          "path": "references/ranking-analysis-templates.md",
          "lines": 127
        },
        {
          "name": "tracking-setup-guide.md",
          "type": "file",
          "path": "references/tracking-setup-guide.md",
          "lines": 127
        }
      ]
    },
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 105
    }
  ]
}
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall