Skip to content

docs(ci): add ai agent support section and install command#274

Merged
stephansama merged 6 commits into
mainfrom
stephansama/ste-184-add-tanstack-intent-to-packages
May 10, 2026
Merged

docs(ci): add ai agent support section and install command#274
stephansama merged 6 commits into
mainfrom
stephansama/ste-184-add-tanstack-intent-to-packages

Conversation

@stephansama
Copy link
Copy Markdown
Owner

Checklist

  • Latest changes from main have been merged
  • Conflicts have been resolved
  • The branch is pointing to main
  • Eslint hasn't reported any issues.
  • All unit tests pass

@changeset-bot
Copy link
Copy Markdown

changeset-bot Bot commented May 10, 2026

🦋 Changeset detected

Latest commit: bf8079d

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 8 packages
Name Type
@stephansama/astro-iconify-svgmap Patch
@stephansama/typed-templates Patch
@stephansama/ai-commit-msg Patch
@stephansama/eslint-config Patch
@stephansama/multipublish Patch
@stephansama/typed-events Patch
@stephansama/auto-readme Patch
@stephansama/typed-env Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@vercel
Copy link
Copy Markdown

vercel Bot commented May 10, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
packages Ready Ready Preview, Comment May 10, 2026 8:33pm

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 10, 2026

Review Change Stack

Warning

Rate limit exceeded

@stephansama has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 51 minutes and 11 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 58b1af1a-277e-4763-ad4a-aa5646644385

📥 Commits

Reviewing files that changed from the base of the PR and between 77b8243 and bf8079d.

📒 Files selected for processing (29)
  • .changeset/proud-rabbits-bake.md
  • .github/workflows/check-skills.yml
  • README.md
  • _artifacts/README.md
  • _artifacts/domain_map.yaml
  • _artifacts/skill_spec.md
  • _artifacts/skill_tree.yaml
  • core/ai-commit-msg/README.md
  • core/ai-commit-msg/package.json
  • core/ai-commit-msg/skills/ai-commit-msg/SKILL.md
  • core/astro-iconify-svgmap/package.json
  • core/astro-iconify-svgmap/skills/astro-iconify-svgmap/SKILL.md
  • core/auto-readme/package.json
  • core/auto-readme/skills/auto-readme/SKILL.md
  • core/eslint-config/README.md
  • core/eslint-config/package.json
  • core/eslint-config/skills/eslint-config/SKILL.md
  • core/eslint-config/skills/eslint-config/references/configs.md
  • core/multipublish/README.md
  • core/multipublish/package.json
  • core/multipublish/skills/multipublish/SKILL.md
  • core/typed-env/package.json
  • core/typed-env/skills/typed-env/SKILL.md
  • core/typed-events/package.json
  • core/typed-events/skills/react-typed-events/SKILL.md
  • core/typed-events/skills/typed-events/SKILL.md
  • core/typed-templates/package.json
  • core/typed-templates/skills/typed-templates/SKILL.md
  • scripts/README.md
📝 Walkthrough

Walkthrough

This PR integrates the @tanstack/intent skills framework into the @stephansama monorepo by adding dependency configuration, generating artifact manifests documenting all nine skills (typed-events, typed-env, typed-templates, eslint-config, multipublish, auto-readme, ai-commit-msg, astro-iconify-svgmap, react-typed-events), and creating comprehensive SKILL.md documentation for each package with setup instructions, usage patterns, and documented failure modes.

Changes

Skills Framework Integration

Layer / File(s) Summary
Workspace & Dependency Setup
pnpm-workspace.yaml, package.json
Adds @tanstack/intent@0.0.41 to pnpm workspace catalog and monorepo root dependencies.
Artifact Manifests
_artifacts/domain_map.yaml, _artifacts/skill_spec.md, _artifacts/skill_tree.yaml
Generates three interconnected artifact files defining nine skills across four domains, documenting APIs, failure modes, cross-skill tensions, and gaps.
Configuration & Documentation
.config/.cspell.json, README.md
Adds spellcheck ignores for antfu, llms, tanstack, tsnapi and creates new README section with npx @tanstack/intent@latest install command.
Package Metadata
core/*/package.json
All nine packages updated with tanstack-intent keyword, @tanstack/intent devDependency, and skills directory added to files list for publication.
Skill Documentation
core/*/skills/*/SKILL.md, core/eslint-config/skills/eslint-config/references/configs.md
Comprehensive documentation for all skills including setup, usage patterns, configuration options, and "Common Mistakes" sections with wrong/correct examples.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

Poem

🐰 A monorepo finds clarity at last,
Nine skills now mapped, tensions contrasted,
Each package docs bloom with care,
Failure modes caught mid-air,
Tanstack intent makes wisdom abound! ✨

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The PR title 'docs(ci): add ai agent support section and install command' accurately summarizes the main change—adding AI agent support documentation and installation instructions to the README, which is evident from the raw summary showing README.md updates with a new 'AI Agent Support' section and install command.
Description check ✅ Passed The PR description matches the provided template structure and includes all required checklist items (merged changes, conflicts resolved, branch pointing to main, eslint passing, unit tests passing), though the description is minimal and does not elaborate on the changes beyond the checklist.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch stephansama/ste-184-add-tanstack-intent-to-packages

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@socket-security
Copy link
Copy Markdown

socket-security Bot commented May 10, 2026

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff Package Supply Chain
Security
Vulnerability Quality Maintenance License
Added@​tanstack/​intent@​0.0.417810010099100

View full report

@socket-security
Copy link
Copy Markdown

socket-security Bot commented May 10, 2026

All alerts resolved. Learn more about Socket for GitHub.

This PR previously contained dependency changes with security issues that have been resolved, removed, or ignored.

View full report

Copy link
Copy Markdown

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request implements AI Agent Support by integrating @tanstack/intent and adding skill definitions for all monorepo packages. Key additions include a domain map, skill specification, and individual SKILL.md files for each package. The review feedback highlights several discrepancies where the library_version in the new skill metadata does not align with the actual package versions in package.json.

Comment thread core/ai-commit-msg/skills/ai-commit-msg/SKILL.md Outdated
Comment thread core/eslint-config/skills/eslint-config/SKILL.md Outdated
Comment thread core/multipublish/skills/multipublish/SKILL.md Outdated
Comment thread core/typed-env/skills/typed-env/SKILL.md Outdated
Comment thread core/typed-templates/skills/typed-templates/SKILL.md Outdated
@codecov
Copy link
Copy Markdown

codecov Bot commented May 10, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ All tests successful. No failed tests found.

📢 Thoughts on this report? Let us know!

@pkg-pr-new
Copy link
Copy Markdown

pkg-pr-new Bot commented May 10, 2026

Open in StackBlitz

@stephansama/ai-commit-msg

pnpm add https://pkg.pr.new/@stephansama/ai-commit-msg@274

@stephansama/alfred-kaomoji

pnpm add https://pkg.pr.new/@stephansama/alfred-kaomoji@274

@stephansama/astro-iconify-svgmap

pnpm add https://pkg.pr.new/@stephansama/astro-iconify-svgmap@274

@stephansama/auto-readme

pnpm add https://pkg.pr.new/@stephansama/auto-readme@274

@stephansama/catppuccin-jsonresume-theme

pnpm add https://pkg.pr.new/@stephansama/catppuccin-jsonresume-theme@274

@stephansama/catppuccin-opml

pnpm add https://pkg.pr.new/@stephansama/catppuccin-opml@274

@stephansama/catppuccin-rss

pnpm add https://pkg.pr.new/@stephansama/catppuccin-rss@274

@stephansama/catppuccin-typedoc

pnpm add https://pkg.pr.new/@stephansama/catppuccin-typedoc@274

@stephansama/catppuccin-xsl

pnpm add https://pkg.pr.new/@stephansama/catppuccin-xsl@274

@stephansama/eslint-config

pnpm add https://pkg.pr.new/@stephansama/eslint-config@274

create-stephansama-example

pnpm add https://pkg.pr.new/create-stephansama-example@274

@stephansama/find-makefile-targets

pnpm add https://pkg.pr.new/@stephansama/find-makefile-targets@274

@stephansama/github-env

pnpm add https://pkg.pr.new/@stephansama/github-env@274

@stephansama/multipublish

pnpm add https://pkg.pr.new/@stephansama/multipublish@274

@stephansama/prettier-plugin-handlebars

pnpm add https://pkg.pr.new/@stephansama/prettier-plugin-handlebars@274

@stephansama/remark-asciinema

pnpm add https://pkg.pr.new/@stephansama/remark-asciinema@274

@stephansama/single-file

pnpm add https://pkg.pr.new/@stephansama/single-file@274

@stephansama/svelte-social-share-links

pnpm add https://pkg.pr.new/@stephansama/svelte-social-share-links@274

@stephansama/typed-env

pnpm add https://pkg.pr.new/@stephansama/typed-env@274

@stephansama/typed-events

pnpm add https://pkg.pr.new/@stephansama/typed-events@274

@stephansama/typed-nocodb-api

pnpm add https://pkg.pr.new/@stephansama/typed-nocodb-api@274

@stephansama/typed-templates

pnpm add https://pkg.pr.new/@stephansama/typed-templates@274

@stephansama/types-github-action-env

pnpm add https://pkg.pr.new/@stephansama/types-github-action-env@274

@stephansama/types-lhci

pnpm add https://pkg.pr.new/@stephansama/types-lhci@274

commit: bf8079d

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 5

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@core/ai-commit-msg/skills/ai-commit-msg/SKILL.md`:
- Around line 26-49: The numbered steps in SKILL.md use incrementing prefixes
(2., 3., 4.) but must use the "1." repeated style to satisfy MD029; update the
ordered list so each item starts with "1." (e.g., the lines describing husky
install, creating `.husky/prepare-commit-msg`, and creating
`ai-commit-msg.config.ts`) so the three list entries use "1." as their prefix
while keeping the existing content and code blocks unchanged.

In `@core/astro-iconify-svgmap/skills/astro-iconify-svgmap/SKILL.md`:
- Around line 27-53: Update the ordered list to "1/1/1" style by changing the
numeric prefixes for the subsequent steps so every list item starts with "1.";
specifically replace the leading "2." in the line starting with "2. Add to
`astro.config.mjs`:", the leading "3." in "3. Import the virtual module in your
base layout (this activates the Vite plugin):", and the leading "4." in "4. Use
icons in any `.astro` component:" to "1." so all ordered items use "1." as the
prefix.

In `@core/multipublish/skills/multipublish/SKILL.md`:
- Around line 153-157: The fenced code block showing the directory tree in
SKILL.md (the block containing "packages/my-pkg/ ... deno.json jsr.json") lacks
a language identifier; update that code fence to include a language tag such as
text (or tree) so it reads ```text at the start of the block to satisfy
markdownlint MD040 and ensure consistent rendering.

In `@core/typed-env/skills/typed-env/SKILL.md`:
- Around line 65-69: The example snippet imports generateExample but then calls
env.generateExample, which is inconsistent; update the snippet so the import and
call match by either importing the env object (e.g., import env from './env' and
call env.generateExample('.env.example')) or call the imported function directly
(generateExample('.env.example')); ensure the symbols in the snippet reference
the same identifier (generateExample or env) to make the example valid.

In `@core/typed-events/skills/react-typed-events/SKILL.md`:
- Around line 19-21: The first-line heading rule is violated because the
sentence "This skill builds on `typed-events`..." appears before the top-level
heading "typed-events — React" in SKILL.md; move the H1 ("# typed-events —
React") to be the very first line of the file and then place the introductory
sentence(s) about building on `typed-events` immediately after that heading so
the file satisfies markdownlint MD041/first-line-heading.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 4bb282bc-99ec-4e94-8ba1-7a9d07f6f005

📥 Commits

Reviewing files that changed from the base of the PR and between 9ac61ed and 77b8243.

⛔ Files ignored due to path filters (1)
  • pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml
📒 Files selected for processing (25)
  • .config/.cspell.json
  • README.md
  • _artifacts/domain_map.yaml
  • _artifacts/skill_spec.md
  • _artifacts/skill_tree.yaml
  • core/ai-commit-msg/package.json
  • core/ai-commit-msg/skills/ai-commit-msg/SKILL.md
  • core/astro-iconify-svgmap/package.json
  • core/astro-iconify-svgmap/skills/astro-iconify-svgmap/SKILL.md
  • core/auto-readme/package.json
  • core/auto-readme/skills/auto-readme/SKILL.md
  • core/eslint-config/package.json
  • core/eslint-config/skills/eslint-config/SKILL.md
  • core/eslint-config/skills/eslint-config/references/configs.md
  • core/multipublish/package.json
  • core/multipublish/skills/multipublish/SKILL.md
  • core/typed-env/package.json
  • core/typed-env/skills/typed-env/SKILL.md
  • core/typed-events/package.json
  • core/typed-events/skills/react-typed-events/SKILL.md
  • core/typed-events/skills/typed-events/SKILL.md
  • core/typed-templates/package.json
  • core/typed-templates/skills/typed-templates/SKILL.md
  • package.json
  • pnpm-workspace.yaml

Comment thread core/ai-commit-msg/skills/ai-commit-msg/SKILL.md Outdated
Comment thread core/astro-iconify-svgmap/skills/astro-iconify-svgmap/SKILL.md Outdated
Comment thread core/multipublish/skills/multipublish/SKILL.md Outdated
Comment thread core/typed-env/skills/typed-env/SKILL.md Outdated
Comment thread core/typed-events/skills/react-typed-events/SKILL.md Outdated
@stephansama stephansama merged commit ce47508 into main May 10, 2026
15 checks passed
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.

1 participant