Add Agent Skills documentation for all packages - #40
Merged
Conversation
Adds skills/, one skill per package in packages/, modeled on the ask-sonner skill from emilkowalski/skills: YAML frontmatter with a trigger-oriented description, then setup, which call to reach for, recipes, and a symptom/cause/fix troubleshooting table. Packages with a larger surface (about-system, manage-storage, code-tree-graph, verify-phone-sms, api2ai) also get an API.md holding the exhaustive prop, option, and env-var tables. Content is written from each package's source, not only its README, so the troubleshooting rows capture real behavior: - about-system: infoFunctions lives on the /api subpath, not the root export; the cache-clearing flag is --refresh, not --cache-clear - create-starter-app: two of the five menu template ids don't match any directory under starter-templates/, and the published files list can't reach the templates at all - verify-phone-sms: /api/verify is a stub that returns verified:true for any input until code storage is implemented - react-app-store-buttons: the package.json name and the README name disagree - api2ai: the directory here is the Next.js site; the CLI ships as the published npm package Also adds skills/README.md as an index with install commands and a note on adding skills for new packages, and links it from the root README. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015NP4dnGytHEr9swAFXfDn1
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This PR adds comprehensive Agent Skills documentation for every package in the monorepo, enabling integration with Claude's Agent Skills system.
Summary
Added
SKILL.mdandAPI.mddocumentation files for 16 packages, following the Agent Skill format. Each skill includes setup instructions, usage patterns, recipes, and troubleshooting guidance extracted from the actual source code rather than just READMEs.Key Changes
New
skills/directory with one subdirectory per package containing:SKILL.md: Setup, picking the right call, recipes, and troubleshooting tableAPI.md: Detailed reference for CLI flags, function signatures, environment variables, and generated output (where applicable)Skills added (16 total):
ask-about-system— system-info CLI and libraryask-api2ai— MCP server generation from OpenAPI specsask-app-store-buttons— React app store download badgesask-cloudflare-to-claude-fix— Cloudflare Queue consumer for build failuresask-code-tree-graph— dependency graph and file tree componentsask-create-cloud-db— Turso database creation CLIask-create-starter-app— interactive template scaffolderask-export-svg-typescript— SVG-to-TypeScript icon generatorask-git0— GitHub repo search and download CLIask-manage-storage— unified S3/R2/B2 clientask-open-ready— dev server wrapper with browser/AI launchask-server-shell-setup— VPS environment bootstrapask-shadcn-theme-menu— shadcn/ui theme switcherask-verify-phone-sms— SMS verification APIask-web2mobile— website-to-mobile-app wrapperRoot
skills/README.mdwith installation instructions and a reference table linking to all skillsUpdated root
README.mdwith a new "Agent Skills" section pointing to the skills directoryImplementation Details
SKILL.mdfollows a consistent structure: description, setup, picking the right call, recipes, and a troubleshooting tableAPI.mdfiles provide exhaustive reference material (CLI options, function signatures, environment variables, generated file layouts, error codes)npx skills@latest addcommandhttps://claude.ai/code/session_015NP4dnGytHEr9swAFXfDn1