tanstack-intent

Synchronizes TanStack Intent skill files with gmt source API changes and validates them.

6|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/northguild/gmt --skill tanstack-intent-northguild
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tanstack-intent
Source: https://github.com/northguild/gmt/tree/main/.agents/skills/tanstack-intent
Command: npx skills add https://github.com/northguild/gmt --skill tanstack-intent-northguild

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @tanstack/intent.

What problem does it solve? Agent-facing skill documentation for the @northguild/gmt date library drifts out of sync whenever the source API changes, causing agents to reference renamed, removed, or nonexistent functions. This Skill audits source changes and updates the skill files, artifact registries, and version metadata so downstream consumers always see an accurate API surface. ## Core Features & Use Cases - Change Auditing: Diffs packages/gmt/src/ against main, reads pending changesets, and builds a list of new, renamed, or removed exports that affect skill content. - Skill File Maintenance: Updates existing SKILL.md files (descriptions, code examples, version bumps, ICU notes) or scaffolds new skills when a change spans multiple domains. - Artifact Registry Updates: Keeps _artifacts/skill_tree.yaml and _artifacts/domain_map.yaml in sync with covers lists, tasks, and cross-references. - Validation & Staleness Checks: Runs intent validate and intent stale to enforce frontmatter schema, the 500-line cap, and version alignment. - Use Case: After adding a new relative-time formatting function to gmt, run this Skill to update the format-relative-time skill, bump library_version across all skills, refresh the domain map, and confirm validation passes. ## Quick Start Ask the agent to run the tanstack-intent skill to audit recent gmt source changes and update the affected skill files and artifacts.

Frequently Asked Questions about tanstack-intent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep agent skill files in sync with library source code?▼

Run this skill after any change to packages/gmt/src exports. It audits git diffs and changesets, updates the affected SKILL.md files and _artifacts registries, then validates everything with the intent CLI.

When should I create a new TanStack Intent skill instead of updating one?▼

Create a new skill when a change spans multiple domains or value types with shared concepts, introduces a new mental model, or would push an existing skill past the 500-line limit. Otherwise extend the existing skill's covers list and examples.

What does intent validate check in skill files?▼

It checks that frontmatter parses with required name and description fields, the name matches the directory, descriptions stay under 1024 characters, files stay under 500 lines, and client-specific fields live under the nested metadata key.

Why does intent validate fail with a metadata nesting error?▼

Skills written against Intent 0.0.x had type, library, and library_version as top-level frontmatter fields. Intent 0.1+ requires them nested under a metadata key. Run intent validate with the --fix flag to migrate automatically.

How do I bump library_version across all skill files at once?▼

Run pnpm exec intent validate packages/gmt/skills --set-version <next-version>. This updates metadata.library_version in every SKILL.md, though you still must bump library.version and generated_at in skill_tree.yaml manually.