# The electricblaze-feeds agent skill for Claude Code, Codex and other agents

**Status, checked 2026-09-18:** the skill is part of the `electricblaze` repository and npm package 0.1.2. It covers Instagram only and says so: TikTok and YouTube are marked planned, and real posts are routed to the widget until the 0.2 API.

> A `SKILL.md` with the workflow, the feed schema and dated Instagram API facts. With it installed, a request like "add our Instagram to the footer" ends with a working component instead of a hand-written token fetch.

Canonical: https://electricblaze.com/developer/instagram-feed/skill.html

## At a glance

- **Use it when:** you or your team build sites with a coding agent and want Instagram feed requests handled the same way every time, with the account step handed to a human.
- **Do not use it when:** the project already has its own Instagram integration that works. The skill would suggest replacing a fetch you are happy with.
- **What the human does:** approves the install. Later, the site owner connects the Instagram account when real posts are needed.
- **Next step:** run `npx electricblaze skill` in the project, or `npx skills add ElectricBlaze/electricblaze` for any agent the skills CLI supports.

## Install it

| You use | Command | Installs to |
|---|---|---|
| Claude Code and Codex, per project | `npx electricblaze skill` | `.claude/skills/` and `.agents/skills/`; `--agent=claude` or `--agent=codex` picks one |
| Any agent the skills CLI knows | `npx skills add ElectricBlaze/electricblaze` | The directory of the agent you choose; `-a claude-code -y` skips the questions |
| Claude Code, as a plugin | `/plugin marketplace add ElectricBlaze/electricblaze`, then `/plugin install electricblaze@electricblaze` | Your Claude Code plugins |
| By hand | Copy `skills/electricblaze-feeds/` from [the repository](https://github.com/ElectricBlaze/electricblaze) | Anywhere your agent reads skills |

We ran both command-line routes on 2026-09-18. `npx skills add ElectricBlaze/electricblaze --list` finds one skill, `electricblaze-feeds`. The electricblaze route prints what it wrote:

`npx electricblaze skill --json` in an empty project (paths trimmed):

```json
{
  "ok": true,
  "skill": "electricblaze-feeds",
  "agents": ["claude", "codex"],
  "files": [
    { "agent": "claude", "path": ".claude/skills/electricblaze-feeds/SKILL.md", "status": "written" },
    { "agent": "claude", "path": ".claude/skills/electricblaze-feeds/references/schema.md", "status": "written" },
    { "agent": "claude", "path": ".claude/skills/electricblaze-feeds/references/platforms.md", "status": "written" },
    { "agent": "codex", "path": ".agents/skills/electricblaze-feeds/SKILL.md", "status": "written" },
    { "agent": "codex", "path": ".agents/skills/electricblaze-feeds/references/schema.md", "status": "written" },
    { "agent": "codex", "path": ".agents/skills/electricblaze-feeds/references/platforms.md", "status": "written" }
  ],
  "next": "Start a new agent session in this project; the skill triggers on requests like \"add an Instagram feed to the footer\"."
}
```

A skill you edited is never overwritten. Start a new agent session afterwards: agents read skill descriptions when a session begins.

## When it triggers

An agent loads a skill when the request matches its description. This is the description, word for word:

> Add an Instagram feed (posts, reels, carousels) to a website or app with ElectricBlaze; TikTok and YouTube feeds are planned, not available yet. Use when asked to show social media posts on a page, an Instagram grid or reels in a footer, or when Instagram Graph API / Basic Display API / access token questions come up.
>
> [SKILL.md](https://github.com/ElectricBlaze/electricblaze/blob/main/skills/electricblaze-feeds/SKILL.md), front matter, version 0.1.2

Prompts that trigger it in practice: "show our latest Instagram posts in the footer", "add a reels strip to the home page", "my Instagram feed stopped working after Basic Display was shut down".

## What it tells the agent to do

1. Run `npx electricblaze add instagram-feed --json` and read `framework`, `files`, `notes` and `next`.
2. Wire the result in: the Server Component in Next.js, the four-line snippet in plain HTML, or a native component over the JSON for Astro, SvelteKit, Nuxt and the other `data` frameworks.
3. Restyle freely, but keep the "demo feed" label until real data flows.
4. Filter on request: `formats={["reel"]}` in Next.js, `data-formats="reel"` in HTML, `limit` for fewer posts.
5. Check with `npx electricblaze doctor --json`; every failing check carries a `next` command.
6. Hand the account step to a human: the widget today, `connect` in 0.2.

The skill also carries a list of things never to do. It forbids scraping instagram.com, putting a token in a client-side fetch to graph.instagram.com, setting `ELECTRICBLAZE_API_KEY` before 0.2, editing `feed.d.ts`, and faking real posts by editing the demo JSON.

## What is inside

| File | Contents |
|---|---|
| `SKILL.md` | Front matter with name and description, the six-step workflow, the never-do list, a quick view of the data shape |
| `references/schema.md` | Schema v1 field by field; the same contract as [the schema page](https://electricblaze.com/developer/instagram-feed/schema.html) |
| `references/platforms.md` | Instagram API facts with a check date and sources: Basic Display shutdown, professional accounts only, 60-day tokens, reel and carousel fields |

The format is the open [Agent Skills](https://agentskills.io) standard: a folder with a `SKILL.md` that has YAML front matter. Claude Code reads it from `.claude/skills/`, Codex from `.agents/skills/`.

## Without the skill: the AGENTS.md block

If a project has `AGENTS.md` or `CLAUDE.md`, `npx electricblaze add` appends a short block between `<!-- electricblaze:start -->` and `<!-- electricblaze:end -->`. It gives any agent that opens the project the essentials, even without the skill:

AGENTS.md (block written by add):

```md
## Social feeds (ElectricBlaze)

The Instagram feed on this site comes from ElectricBlaze (TikTok and YouTube
are planned, not available yet). The feed shape is schema v1 (see the copied
`feed.d.ts`) ...

- `npx electricblaze preview instagram --json` prints the current feed
  (demo data until an account is connected).
- `npx electricblaze doctor --json` checks the setup and explains what to do next.
- Real posts need a human. Today the site owner connects the account in the
  ElectricBlaze widget at https://electricblaze.com and pastes its embed
  snippet where the feed belongs. The JSON API for this component
  (`npx electricblaze connect instagram`) ships in 0.2.
```

## Why a skill and not only docs

Without guidance a coding agent writes the Instagram code itself. The code looks right in review and fails weeks later. The usual failures are a long-lived token that expires after 60 days ([Meta: access_token reference](https://developers.facebook.com/docs/instagram-platform/reference/access_token), checked 2026-09-18) and image links that stop loading on a cached page ([media URL expired](https://electricblaze.com/developer/instagram-feed/media-url-expired.html)).

A skill moves the decision to the start of the task. The agent learns what exists today, what the human has to do, and which command gives it a working grid in one step.

## FAQ

### Does the skill work outside Claude Code and Codex?

The files follow the Agent Skills format. `npx skills add ElectricBlaze/electricblaze` installs them for any agent that CLI supports; others can read `SKILL.md` as plain Markdown.

### Does it make network calls?

The skill is text. The commands it suggests are the `electricblaze` CLI, which makes no network calls in 0.1.

### Will it replace my existing Instagram code?

Only if you ask for a feed and let the agent follow it. Remove the skill if your project already has an integration you want to keep.

### How do I update it?

Run `npx electricblaze@latest skill` again. Files you edited are reported as skipped; `--force` replaces them.

## Related pages

- [The CLI](https://electricblaze.com/developer/instagram-feed/cli.html)
- [Feed schema](https://electricblaze.com/developer/instagram-feed/schema.html)
- [Next.js](https://electricblaze.com/developer/instagram-feed/nextjs.html)
- [Access tokens](https://electricblaze.com/developer/instagram-feed/access-token.html)
- [Changelog](https://electricblaze.com/developer/changelog.html)
- [Developers home](https://electricblaze.com/developer/)

---

ElectricBlaze, updated 2026-09-18. Source of this page: https://electricblaze.com/developer/instagram-feed/skill.html