Skip to content

feat: default agent skills, AI SEO, and Context7 indexing - #54

Merged
jrmybtlr merged 4 commits into
mainfrom
cursor/default-agent-skills-58a8
Sep 5, 2026
Merged

feat: default agent skills, AI SEO, and Context7 indexing#54
jrmybtlr merged 4 commits into
mainfrom
cursor/default-agent-skills-58a8

Conversation

@jrmybtlr

@jrmybtlr jrmybtlr commented Sep 5, 2026

Copy link
Copy Markdown
Owner

Summary

Layers so coding agents actually pick up UseClassy:

  1. Default agent install on init — skills/rules/AGENTS.md unless --no-skills
  2. AI SEO — richer public machine-readable docs for crawlers
  3. Context7context7.json + CI that auto-submits once, then refreshes on every main push

Agent install

  • npx vite-plugin-useclassy init installs agent resources by default
  • Opt out with --no-skills
  • Always-on Cursor rule + broader skill description triggers

AI SEO

  • Richer /llms.txt, /skill.md, /.well-known/llms.txt, /sitemap.xml
  • npm keywords/description + README “For AI assistants” table
  • Homepage JSON-LD + clearer SEO meta

Context7

  • Root context7.json (excludes demos/build noise, ships agent rules)
  • CI workflow .github/workflows/context7-refresh.yml:
    • Refresh on every main push
    • If refresh returns 404, auto-submit GitHub repo + llms.txt, then refresh
    • Soft-skips when CONTEXT7_API_KEY is missing

After merge (manual)

  • Add repo secret CONTEXT7_API_KEY from https://context7.com/dashboard
  • Merge / re-run workflow (first run submits; later runs refresh)
  • Optionally claim the library in the Context7 UI

Test plan

  • vitest run src/tests (262 passed)
  • After deploy: curl llms.txt, /skill.md, /.well-known/llms.txt, /sitemap.xml
  • After secret is set: workflow run succeeds on main
Open in Web Open in Cursor 

Make AI discovery the default path: init now writes the UseClassy skill,
always-on Cursor project rule, scoped rules, and AGENTS.md unless
--no-skills is passed. Broaden the skill description triggers so agents
match UseClassy authoring and Tailwind variant refactors more reliably.

Co-authored-by: Jeremy Butler <jrmybtlr@users.noreply.github.com>
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Sep 5, 2026

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
useclassy-com 1c717e2 Commit Preview URL

Branch Preview URL
Sep 05 2026, 08:51 PM

Enrich llms.txt with when-to-use guidance and syntax, publish the agent
skill at /skill.md, add .well-known/llms.txt plus sitemap.xml, and
strengthen npm/README/SEO metadata so models can discover UseClassy.

Co-authored-by: Jeremy Butler <jrmybtlr@users.noreply.github.com>
@cursor cursor Bot changed the title feat(cli): install agent skills by default on init feat: default agent skills + AI SEO for UseClassy discovery Sep 5, 2026
Add context7.json so Context7 indexes README/skill docs (not demos),
documents agent authoring rules, and records the one-time submit steps
for the GitHub repo plus public llms.txt.

Co-authored-by: Jeremy Butler <jrmybtlr@users.noreply.github.com>
@cursor cursor Bot changed the title feat: default agent skills + AI SEO for UseClassy discovery feat: default agent skills, AI SEO, and Context7 indexing Sep 5, 2026
Add a workflow that refreshes Context7 after every main push, and
auto-submits the GitHub repo plus llms.txt when the library is missing.

Co-authored-by: Jeremy Butler <jrmybtlr@users.noreply.github.com>
@jrmybtlr
jrmybtlr marked this pull request as ready for review September 5, 2026 21:41
@jrmybtlr
jrmybtlr merged commit 415742f into main Sep 5, 2026
10 checks passed
@jrmybtlr
jrmybtlr deleted the cursor/default-agent-skills-58a8 branch September 5, 2026 21:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants