agentleFS
Sign inStart free
koinodkoinod/skills/seo-os/SKILL.md

seo-os

Skill0 starsChanged 6 months agoMITView on GitHub

Plug-and-play SEO OS — sitemap, robots, JSON-LD, GBP, audit. Drop seo.config.json + run build. For koino.capital and any static/SPA site.

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

Create a free account to mount
Files
SKILL.md

SEO OS — Plug-and-Play

Live source: koinod/skills/seo-os (this folder) + mirrored in koinod/koino-storefront/seo/ (deployed to koino.capital).

What it solves

Google ranking needs: crawlability (sitemap/robots), indexation (canonicals), on-page (titles/meta/OG), structured data (JSON-LD), and GBP (LocalBusiness).

This skill is plug-and-play: copy 2 files, run 1 command, done. No CMS plugin.

Quick start

cp seo-os/seo.config.json ./seo.config.json
cp -r seo-os/seo ./seo
# edit seo.config.json (siteUrl, org, localBusiness, calLink, ogImage)
node seo/build.js      # -> sitemap.xml + robots.txt + llms.txt
node seo/inject.js     # -> injects Organization/WebSite/LocalBusiness JSON-LD (idempotent)
node seo/audit.js      # -> heads audit (see audit-report.json)

For SPA (Vite/Next)

cp -r seo-os/src-seo ./src/seo
# import { Seo } from './seo/Seo'; then <Seo title="..." jsonLd={[orgJsonLd()]} />
node src/seo/scripts/generate-sitemap.mjs  # -> public/sitemap.xml

Files

  • seo.config.json — single source of truth
  • seo/build.js — sitemap + robots + llms (stdlib only)
  • seo/inject.js — inject JSON-LD into html heads
  • seo/audit.js — title/desc/canonical/OG/H1/jsonld audit
  • seo/gbp/GBP_CHECKLIST.md + citations.csv — GBP ranking kit
  • seo/README.md — full docs

Live evidence

  • koinod/koino-storefront — 70 pages, live sitemap at https://koino.capital/sitemap.xml, robots at /robots.txt, audit via node seo/audit.js
  • KOINO/Koino_Creative_Web/src/seo — React Seo component + jsonld generators

Booking + Quiz tie-in

  • assets/booking.js — Cal embed with gated quiz (localStorage koino_quiz)
  • assets/quiz.js + quiz.html — 30-sec qualifying quiz (vertical/revenue/bottleneck/contact), qualified -> Cal modal, else Growth Kit
  • Env/Config: calLink in seo.config.json -> meta[name="cal-link"] -> booking.js

GBP

See seo/gbp/GBP_CHECKLIST.md — NAP -> Posts -> Q&A -> Reviews -> Citations. Update seo.config.json localBusiness once, sync to GBP manually.

Redesign note

Favicon/OG are part of SEO: transparent stag (/favicon.svg viewBox 240 60 920 920), PNG favicons (16/32/48/180/192/512), /assets/og-image.png (1200x630, dark gradient + stag). Generated via seo/build.js asset step or PIL.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free