create-vercel-ai-issue

Creates well-formed GitHub issues in vercel/ai using the gh CLI.

1.2k|117|Updated Mar 22, 2025
One-click install
npx skills add https://github.com/FranciscoMoretti/sparka --skill create-vercel-ai-issue
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-vercel-ai-issue
Source: https://github.com/FranciscoMoretti/sparka/tree/main/.agents/skills/create-vercel-ai-issue
Command: npx skills add https://github.com/FranciscoMoretti/sparka --skill create-vercel-ai-issue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reporting AI SDK bugs to the vercel/ai repository requires structured issues with logs, code blocks, versions, and reproduction steps, and shell interpolation can corrupt backticks and code blocks when creating issues from the command line.

Core Features & Use Cases

  • Structured Issue Authoring: Prepares issue bodies with sections for the problem, exact error, package versions, minimal reproduction, expected behavior, and actual behavior.
  • Shell-Safe Body Files: Writes complex Markdown to a temporary body file so backticks and code blocks survive shell interpolation.
  • Authenticated gh CLI Workflow: Verifies gh auth status, inspects the vercel/ai repository, and runs gh issue create with a body file, returning the created issue URL.
  • Use Case: After hitting an AI SDK streaming bug, ask the assistant to draft and file a vercel/ai issue containing your error logs, package versions, and a minimal reproduction without mangling the Markdown.

Quick Start

Ask the assistant to create a vercel/ai GitHub issue describing your AI SDK bug with the error logs, package versions, and reproduction steps you provide.

Frequently Asked Questions about create-vercel-ai-issue

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

FAQPage Schema
How do I create a GitHub issue with the gh CLI?

Run gh issue create with the -R flag for the repository, a --title, and --body-file pointing to a file containing the issue body. Verify access first with gh auth status before writing the issue.

How do I report a bug to the vercel/ai repository?

Prepare a focused issue with sections for the problem, exact error, package versions, minimal reproduction, expected behavior, and actual behavior. Then create it with gh issue create -R vercel/ai using a body file.

Why do backticks and code blocks break when creating GitHub issues from the shell?

Shell interpolation alters backticks and special characters when Markdown is passed inline as an argument. Writing the body to a temporary file and passing it with --body-file preserves the content exactly.

Does this skill create the GitHub issue automatically?

No, it does not create the external issue unless the user explicitly authorizes that write. It prepares the issue content and only runs gh issue create after confirmation.

What information should an AI SDK bug report include?

Include the problem statement, the exact error message, relevant package versions, a minimal reproduction, expected behavior, and actual behavior. Logs and code blocks should be placed in a body file to avoid shell corruption.