Agent skill

Narrative Tracker

by aeonfun in aeonfun/aeon

Track rising, peaking, and fading crypto/tech narratives with quantitative mindshare + velocity signals and explicit positioning calls

MITAuto-check passedMarketing & SEO

Install Narrative Tracker

skills CLI
$ npx skills add aeonfun/aeon --skill narrative-tracker -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aeonfun/aeon narrative-tracker --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aeonfun/aeon.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/narrative-tracker .claude/skills/narrative-tracker && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
narrative-tracker
GitHub stars
767
Token cost
~3k tokens
SKILL.md length
1,315 words
Files
1
Skills in repo
82
Repo updated
First seen
Licence
MIT

At a glance

Track rising, peaking, and fading crypto/tech narratives with quantitative mindshare + velocity signals and explicit positioning calls

  • Works in 7 steps: Ingest signals → Score each narrative → Detect transitions → …
  • Marketing & SEO work in your project
  • SKILL.md covers Goal, Steps, Guidelines and Fetching, plus 1 more section
  • Calls jq; reaches api.x.ai; needs XAI_API_KEY

What it does

Narrative Tracker is an agent skill from aeonfun/aeon. Track rising, peaking, and fading crypto/tech narratives with quantitative mindshare + velocity signals and explicit positioning calls

Its SKILL.md is about 3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO. It works with xAI Grok. The repository describes itself as: The most autonomous AI agent framework: runs unattended on GitHub Actions, self-healing skills, drives Claude Code, Grok, Codex & more. No approval loops. Configure once, forget… The licence is MIT.

When your agent uses it

  • Marketing & SEO work in your project

Example prompts

  • “/narrative-tracker”

Requirements

  • A credential in XAI_API_KEY

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Ingest signals
  2. Score each narrative
  3. Detect transitions
  4. Flag reflexivity
  5. Format the notification
  6. Send via ./notify
  7. Log record

What it can do on your machine

Read from SKILL.md and the folder at commit f252074. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • jq

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.x.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • XAI_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Narrative Tracker loads about 3k tokens when it runs. Until then it costs about 38 tokens; SKILL.md has 1,315 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~38
When it runs · the whole SKILL.md, loaded when a task matches
~3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from aeonfun/aeon at commit f252074, republished under its MIT licence (© aeonfun). 1,315 words, ~3,029 tokens.

Download SKILL.mdSave it as .claude/skills/narrative-tracker/SKILL.md (or your agent's skills folder).
name
narrative-tracker
description
Track rising, peaking, and fading crypto/tech narratives with quantitative mindshare + velocity signals and explicit positioning calls
metadata.commits
true
metadata.permissions
contents:write
metadata.title
Narrative Tracker
metadata.mode
read-only
metadata.category
crypto
metadata.tags
crypto, research
metadata.requires
XAI_API_KEY
<!-- autoresearch: variation B — sharper output (quantitative mindshare + velocity + explicit positioning calls, with multi-angle inputs from A, dedup/empty-state handling from C, and transition detection from D) -->

Read memory/MEMORY.md for context on prior narrative observations. Read the last 3 days of memory/logs/ — specifically any prior ### narrative-tracker entries — to (a) avoid re-reporting the same narratives without new info, and (b) detect phase transitions vs the last run.

Goal

Produce a decision-grade narrative map: every narrative gets a mindshare score, a velocity arrow, a sentiment tag, named drivers, and an explicit position call. Classification without a position call is noise.

Steps

1. Ingest signals

a. X/Twitter narratives — X.AI API (primary). The primary signal is a direct curl to the X.AI Responses API with Grok's x_search tool — see ## Fetching below for the full contract. XAI_API_KEY is injected into this skill's environment via requires:; it is present and valid, so this path is required whenever the key check prints KEY_PRESENT. Set the Bash tool timeout to ≥180000 when running the curl (x_search takes 30-120s) and capture the HTTP status:

bash
FROM_DATE=$(date -u -d "3 days ago" +%Y-%m-%d 2>/dev/null || date -u -v-3d +%Y-%m-%d)
TO_DATE=$(date -u +%Y-%m-%d)
# Presence check uses the ${VAR:+x} modified expansion, NOT a bare $XAI_API_KEY — the bare
# form trips the Bash secret-expansion analyzer; the :+ form does not (it never puts the value on the line).
[ -n "${XAI_API_KEY:+x}" ] && echo KEY_PRESENT || echo KEY_UNSET
# Build the JSON payload to a file with jq (do NOT hand-assemble it), then POST the file.
# TWO SEPARATE commands on purpose: the jq (which interpolates $PROMPT/$FROM_DATE/$TO_DATE)
# is kept OUT of the ./secretcurl command — never pipe jq into secretcurl, and never put a
# $VAR in the secretcurl line, or the Bash permission analyzer blocks the network call.
# The `>` redirect to /tmp is fine in read-only mode (it is not a repo path; nothing reverts it).
PROMPT="Search X for the dominant crypto and tech narratives from ${FROM_DATE} to ${TO_DATE}. Return 12-15 distinct narrative threads. For each: 1) short label, 2) 3-5 representative @handles driving it, 3) 2-3 tweet permalinks, 4) rough mention-volume descriptor (niche / growing / saturating / cooling), 5) the strongest one-line bear case against it."
jq -n --arg p "$PROMPT" --arg fd "$FROM_DATE" --arg td "$TO_DATE" \
  '{model:"grok-4.7", input:[{role:"user",content:$p}], tools:[{type:"x_search",from_date:$fd,to_date:$td}]}' \
  > /tmp/xai-nt-payload.json
HTTP=$(./secretcurl -s -o /tmp/xai-nt.json -w '%{http_code}' --max-time 150 -X POST "https://api.x.ai/v1/responses" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {XAI_API_KEY}" \
  -d @/tmp/xai-nt-payload.json)
echo "xai http=$HTTP bytes=$(wc -c </tmp/xai-nt.json)"

Run that block verbatim (do not hand-reassemble the JSON — the jq -n builder exists precisely so quoting/expansion can't break; keep the jq and the ./secretcurl as two separate commands). The echo "xai http=$HTTP ..." line must appear in your output — it is your proof the call ran. On HTTP=200 with a non-empty body, parse /tmp/xai-nt.json with jq -r '.output[] | select(.type == "message") | .content[] | select(.type == "output_text") | .text' and use that as the primary narrative signal (SOURCE=api).

b. WebSearch / WebFetch fallback (last-resort only). You may reach for this only after you have shown an xai http=<code> line proving Path A actually ran and returned a non-2xx code (or an empty body, or timed out). If you have no xai http= line, you did not run the call - go back and run it. Reach for the fallback only when Path A genuinely fails - KEY_UNSET, a non-2xx HTTP code, an empty parse, or a timeout. It is lower quality (WebSearch favours old high-engagement posts) and is never co-equal with Path A. Record the fetch failure in your final output with the true reason - key-unset | http-<code> | empty | timeout - never "XAI_API_KEY unavailable" when the key was set (a slow curl is a timeout, not a missing key). Then compile narratives via WebSearch (crypto narrative ${TO_DATE}, AI agent crypto trend this week) and WebFetch on individual tweet URLs; discard anything older than the 3-day window.

c. Quantitative reference points (supplement). Independently of the fetch path, cross-check mindshare against external quantitative benchmarks with one WebSearch: DefiLlama narrative tracker OR Kaito mindshare leaderboard. Pull 1-2 concrete numbers (project name, metric, link) to calibrate the mindshare scores in step 2. This is a calibration cross-check, not a narrative source. Do not paraphrase — extract facts.

d. Memory diff. Extract narrative labels mentioned in the last 3 days of ### narrative-tracker log entries. You'll compare against them in step 4.

2. Score each narrative

For each distinct narrative (merge near-duplicates aggressively — "AI agents" and "agentic crypto" are the same), assign:

FieldScaleHow to decide
Mindshare1-51 = fringe, 3 = known in the sector, 5 = dominating timelines. Base on count of distinct drivers + whether you had to dig or it surfaced unprompted.
Velocity↑↑ / ↑ / → / ↓ / ↓↓Compared to the 3-day window or prior log entries. ↑↑ = tripled in attention, ↓↓ = was loud 3 days ago, now absent.
PhaseEmerging / Rising / Peak / FadingUse the velocity + mindshare combo. Emerging = low mindshare, high velocity. Peak = high mindshare, flat/down velocity. Fading = high mindshare last week, now ↓.
SentimentBull / Mixed / Bear / CopeCope = bag-holder energy, bear narratives dressed as bull takes.
Drivers2-3 namedAccounts, projects, or funds amplifying it. Include @handles.
Bear case1 lineThe sharpest argument against. If the consensus is obviously right, say so and mark "no contrarian edge".
PositionFRONT-RUN / RIDE / FADE / WATCH / IGNOREFRONT-RUN = emerging + contrarian edge. RIDE = rising, not yet peaked. FADE = peak with weak fundamentals or reflexivity flip. WATCH = unclear. IGNORE = mindshare 1-2 with no catalyst.

Drop any narrative that ends up IGNORE unless it's structurally important — noise reduction is the goal.

3. Detect transitions

Compare today's narratives to the last 3 days of logs:

  • NEW — narrative wasn't in prior logs at all
  • PROMOTED — phase moved up (e.g. Emerging → Rising)
  • DEMOTED — phase moved down
  • DEAD — was in prior logs, now absent from all signals

Transitions are the highest-value output — the point of a daily tracker is to catch inflection points, not re-report the zeitgeist.

4. Flag reflexivity

For each narrative, flag if the story itself is moving outcomes:

  • Token prices moving on narrative alone (no fundamentals shift)
  • Projects rebranding/pivoting to ride the narrative
  • VCs publicly endorsing to manufacture legitimacy
  • Prediction markets or on-chain flows reflecting narrative belief

Only flag explicit cases with a concrete example. "Reflexivity" without evidence is hand-waving.

Show full SKILL.md (553 more words)Show less
5. Format the notification

Keep under 4000 chars. Lead with transitions and reflexivity — those are the decisions. Classification goes below.

*Narrative Tracker — ${today}*

TRANSITIONS
• NEW: <label> — <why it matters> — <link>
• PROMOTED: <label> Rising → Peak — <what flipped>
• DEMOTED: <label> Peak → Fading — <what cooled>
• DEAD: <label> — gone

REFLEXIVITY ALERT
• <narrative> — <concrete evidence the story is moving outcomes>

POSITIONS
• FRONT-RUN: <label> (mindshare 2 ↑↑, Bull) — <driver> — <bear case> — <link>
• RIDE: <label> (3 ↑, Bull) — <driver> — <bear case>
• FADE: <label> (5 → Cope) — <driver> — <reflexivity note>

MAP
Emerging: <labels>
Rising: <labels>
Peak: <labels>
Fading: <labels>

If absolutely nothing new or notable (no transitions, no reflexivity, no FRONT-RUN/FADE calls): send a one-line update instead of the full template — *Narrative Tracker — ${today}*: no phase transitions, map unchanged from <last_date>.

6. Send via ./notify
7. Log record

This skill is read-only, so the workflow's read-only guard writes its ### narrative-tracker log entry from your captured output; a self-written entry would be a duplicate. Don't append to memory/logs/ yourself - put this record in your final output: the full structured output (not just the notification - include all narratives considered, even IGNOREd ones, so future diffs work). If a full run produced nothing actionable, record NARRATIVE_TRACKER_OK with the narrative labels seen (so tomorrow's diff still has a baseline).

Guidelines

  • Quantitative over vibes. Every narrative gets mindshare 1-5 and a velocity arrow — no exceptions. If you can't score it, drop it.
  • Transitions > classification. A daily tracker's value is catching moves, not listing the weather.
  • Named drivers only. "Crypto Twitter is excited about X" is not a driver. "@handle + @handle + @fund" is.
  • Position calls are mandatory for Emerging/Rising/Peak narratives. If signals are genuinely ambiguous or contradictory, WATCH is an acceptable call — but never omit a position entirely and never invent conviction you don't have.
  • Ruthless dedup. Same narrative under two labels = one narrative. Merge, don't split.
  • Call out cope. Manufactured narratives, coordinated shilling, and dead-cat bounces get tagged explicitly.
  • Prioritize topics tracked in MEMORY.md over generic market chatter.

Fetching

XAI_API_KEY is injected into this skill's environment (declared in requires:). It is present and valid. The primary fetch path is a direct curl to https://api.x.ai/v1/responses with Authorization: Bearer {XAI_API_KEY} (model grok-4.7, "tools":[{"type":"x_search"}]). There is no network sandbox blocking this - earlier versions of this skill claimed there was, and that is stale and false. Just make the call.

Rules:

  1. Check, don't assume. Run [ -n "${XAI_API_KEY:+x}" ] && echo KEY_PRESENT || echo KEY_UNSET (the ${VAR:+x} form, not bare $XAI_API_KEY — the bare form trips the secret-expansion analyzer and falsely reads as unset). If KEY_PRESENT (it will be), Path A (the curl in step 1a) is required before any fallback.
  2. Allow enough time. The x_search call typically takes 30-120s. When you invoke the Bash tool for the curl, set the tool's timeout to at least 180000 (180s) and keep --max-time 150 on the curl so it fails cleanly rather than hanging. A slow curl is not a missing key — never treat a timeout as key-unavailable.
  3. Capture the HTTP status so the fallback decision is fact-based (see the skeleton in step 1a). HTTP=200 with a non-empty parsed body → use it.
  4. Fall back only on a real failure, recording the true reason — key-unset (only if the check printed KEY_UNSET), http-<code> (non-2xx), empty (200 but nothing parsed), or timeout. Never write "XAI_API_KEY unavailable" when the key was set.

WebSearch / WebFetch are last-resort fallbacks only — lower quality, never primary or co-equal. Do not reach for them while the key works.

Environment Variables Required

  • XAI_API_KEY — X.AI API key for Grok's x_search tool. Declared in requires:, so it is injected into this skill's environment and is the primary fetch path for the narrative signal (step 1a). If it is ever unset, the skill degrades to WebSearch/WebFetch at lower quality.
  • Notification channels configured via repo secrets (see CLAUDE.md).

© aeonfun, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/narrative-tracker of aeonfun/aeon.

Open the folder on GitHubat commit f252074

Compare with similar skills

Narrative Tracker next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Narrative Tracker compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Narrative Tracker this skillaeonfun/aeon767—~3kAutomated safety check: PassMIT
Geo Fundamentalswasp-lang/wasp19k8 repos~861Automated safety check: PassMIT
Hreflang and International SEOAgriciDaniel/claude-seo18k5 repos~3.4kAutomated safety check: PassMIT
SEO GeoReScienceLab/opc-skills1.8k4 repos~2.1kAutomated safety check: PassApache-2.0
Ad CreativeLeoYeAI/openclaw-marketing-skills1k8 repos~3.4kAutomated safety check: PassCustom licence
Google SEO APIsAgriciDaniel/claude-seo18k1 repos~4.2kAutomated safety check: PassMIT

Similar skills

  • Geo Fundamentals

    wasp-lang/wasp

    Generative Engine Optimization for AI search engines (ChatGPT, Claude, Perplexity).

    19k GitHub starsUsed in 8 repos~861 tokens
    Marketing & SEOAuto-check passed
  • Hreflang and International SEO

    AgriciDaniel/claude-seo

    Audits, validates and generates hreflang tags for multi-language and multi-region sites in HTML, HTTP headers or XML sitemaps, flagging common code and return-tag mistakes.

    18k GitHub starsUsed in 5 repos~3.4k tokens
    Marketing & SEOAuto-check passed
  • SEO Geo

    ReScienceLab/opc-skills

    SEO & GEO (Generative Engine Optimization) for websites. An agent skill from ReScienceLab/opc-skills.

    1.8k GitHub starsUsed in 4 repos~2.1k tokens
    Marketing & SEOAuto-check passed
  • Ad Creative

    LeoYeAI/openclaw-marketing-skills

    When the user wants to generate, iterate, or scale ad creative — headlines, descriptions, primary text, or full ad variations — for any paid advertising platform.

    1k GitHub starsUsed in 8 repos~3.4k tokens
    Marketing & SEOAuto-check passed
  • Google SEO APIs

    AgriciDaniel/claude-seo

    Pulls real Google data for SEO work: Search Console, PageSpeed Insights, CrUX field data, the Indexing API and GA4 organic traffic, through /seo google commands.

    18k GitHub starsUsed in 1 repo~4.2k tokens
    Marketing & SEOAuto-check passed
  • Analytics

    Nexus-JPF/note-companion

    When the user wants to set up, improve, or audit analytics tracking and measurement.

    869 GitHub starsUsed in 6 repos~2.2k tokens
    Marketing & SEOAuto-check passed

More from aeonfun/aeon

All 82 skills in this repo
  • Browses open tasks on the TaskMarket agent-worker market and, with explicit operator approval, creates tasks, tracks submissions and submits finished work.

    767 GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed
  • Sets up and manages an Aeon agent instance that runs skills on a schedule through GitHub Actions: starting, rescheduling, debugging, editing skills and mining chat history.

    767 GitHub stars~8.8k tokensUpdated yesterday
    Auto-check: warnings
  • Reads a Base Account's address, portfolio and transaction history through the Base MCP server, and stays strictly read-only in unattended Aeon runs, reporting only changes.

    767 GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed
  • Audits every page of a site each day from its sitemap, scores on-page and technical SEO, checks duplicates across pages and reports what changed since the last run.

    767 GitHub stars~5.1k tokensUpdated yesterday
    Auto-check passed
  • Action Converter

    aeonfun/aeon

    5 concrete real-life actions, leverage-scored against open loops with specificity and anti-fluff gates

    767 GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed
  • Aeon Config Doctor

    aeonfun/aeon

    Static linter for an Aeon instance's configuration that catches silent failures such as unquoted schedules, duplicate keys, unconfigured skills and broken MCP references.

    767 GitHub stars~3.3k tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about Narrative Tracker

What does Narrative Tracker do?

Track rising, peaking, and fading crypto/tech narratives with quantitative mindshare + velocity signals and explicit positioning calls. Narrative Tracker is an agent skill from aeonfun/aeon.

When should I use Narrative Tracker?

Narrative Tracker fits situations like: marketing & SEO work in your project.

How do I install Narrative Tracker in Claude Code?

Run `npx skills add aeonfun/aeon --skill narrative-tracker -a claude-code`. Or copy the skill folder (skills/narrative-tracker in aeonfun/aeon) into .claude/skills/narrative-tracker in your project. Claude Code loads it when a task matches its description.

How do I install Narrative Tracker in Codex?

Run `npx skills add aeonfun/aeon --skill narrative-tracker -a codex`. Or copy the skill folder (skills/narrative-tracker in aeonfun/aeon) into .agents/skills/narrative-tracker in your project. Codex loads it when a task matches its description.

Can I use Narrative Tracker in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aeonfun/aeon --skill narrative-tracker -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/narrative-tracker, .gemini/skills/narrative-tracker, .github/skills/narrative-tracker and .opencode/skills/narrative-tracker in your project.

What does Narrative Tracker need to run?

Going by SKILL.md and its folder, Narrative Tracker needs the command-line tools its instructions call (jq) and credentials named XAI_API_KEY. Our summary lists: A credential in XAI_API_KEY.

Does Narrative Tracker access the network?

SKILL.md names 1 domain. In commands or code: api.x.ai; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Narrative Tracker safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Narrative Tracker use?

Narrative Tracker is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Narrative Tracker use?

About 3k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Narrative Tracker?

Skills that share tags, products or a category with Narrative Tracker: Geo Fundamentals (wasp-lang/wasp, 19k stars), Hreflang and International SEO (AgriciDaniel/claude-seo, 18k stars), SEO Geo (ReScienceLab/opc-skills, 1.8k stars) and Ad Creative (LeoYeAI/openclaw-marketing-skills, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Narrative Tracker?

aeonfun (a GitHub organization) maintains it in aeonfun/aeon, which has 767 GitHub stars. The repository holds 82 skills in this directory. The repository was last updated on October 6, 2026.

Source: aeonfun/aeon on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.