Skip to content

feat(skills): added baseline for skills cluster#49

Merged
luanvdw merged 2 commits into
mainfrom
feat/skills-integration
May 29, 2026
Merged

feat(skills): added baseline for skills cluster#49
luanvdw merged 2 commits into
mainfrom
feat/skills-integration

Conversation

@luanvdw
Copy link
Copy Markdown
Member

@luanvdw luanvdw commented May 29, 2026

Adds a baseline Prisma CLI skills cluster for agent-guided Next.js deploys, drawing inspiration from the Prisma Next skills integration. Includes install/discovery docs, validation scripts, focused journey tests, and a CLI help breadcrumb so agents can find the workflow.

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 29, 2026

Review Change Stack

Warning

Review limit reached

@luanvdw, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 49 minutes and 28 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, 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 include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 5b472d84-f16a-4b17-b501-7453da73ebf1

📥 Commits

Reviewing files that changed from the base of the PR and between 03f56c8 and d2ec120.

⛔ Files ignored due to path filters (1)
  • pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml
📒 Files selected for processing (16)
  • .gitignore
  • README.md
  • package.json
  • packages/cli/README.md
  • packages/cli/src/shell/command-meta.ts
  • packages/cli/tests/app.test.ts
  • scripts/validate-skills.mjs
  • scripts/validate-skills.test.mjs
  • skills/DEVELOPING.md
  • skills/README.md
  • skills/journey-tests/01-nextjs-first-deploy.md
  • skills/journey-tests/02-feedback-bug.md
  • skills/journey-tests/README.md
  • skills/prisma-cli-deploy-nextjs/SKILL.md
  • skills/prisma-cli-feedback/SKILL.md
  • skills/prisma-cli/SKILL.md

Walkthrough

This PR introduces a complete agent skills framework for Prisma CLI, enabling LLM-based agents to guide users through Prisma Compute deployments. It includes validation tooling for skill definitions, multiple skills for routing and deployment guidance, CLI help text integration, and manual journey tests to validate agent behavior.

Changes

Agent Skills Framework

Layer / File(s) Summary
Skill Validation Infrastructure
scripts/validate-skills.mjs, scripts/validate-skills.test.mjs, package.json, .gitignore
New Node.js validator script parses frontmatter in skill markdown files, enforces required name and description fields, and checks description length (max 1024 chars). Supports YAML folded/literal scalars and reports structured validation errors. Test suite covers parse failures, length violations, and directory scanning. Package.json adds lint:skills and test:skills scripts. GitIgnore updated for local skill artifacts.
Skill Cluster Documentation & Router
skills/README.md, skills/DEVELOPING.md, skills/prisma-cli/SKILL.md
Cluster README documents included skills, installation (version-aligned with @prisma/cli), and contributing guidelines. Contributor guide establishes authoring rules and verification process. Router skill defines when to use this skill vs. specialized ones, establishes routing rules (Next.js cues → deploy skill, feedback prompts → feedback skill), and documents the canonical deploy flow model (workspace → project → branch → app).
Next.js Deploy Skill
skills/prisma-cli-deploy-nextjs/SKILL.md
Complete agent guidance for Next.js app deployment to Prisma Compute using Prisma CLI. Covers usage boundaries, key concepts (CLI-owned target resolution, PRISMA_SERVICE_TOKEN for headless auth, output: "standalone" requirement), step-by-step workflow (app detection, auth verification, config validation, deploy, verification), common pitfalls, and explicit limitations routing gaps to feedback skill.
Feedback Skill
skills/prisma-cli-feedback/SKILL.md
Agent skill for composing and routing Prisma CLI feedback. Defines GitHub vs. Discord channel routing, structured issue body templates with required CLI/environment metadata, secret redaction rules, and submission workflow using gh issue create with explicit user confirmation gating.
CLI Help Integration & Testing
packages/cli/src/shell/command-meta.ts, packages/cli/tests/app.test.ts, packages/cli/README.md
The app deploy command descriptor adds longDescription describing agent skills for guided Next.js deploys and example command showing skill installation. CLI README includes new "Agent skills" subsection with installation and usage instructions. Test assertions validate help text includes agent skills documentation and pnpm dlx skills@latest --all command.
Developer Setup & Journey Tests
README.md, skills/journey-tests/README.md, skills/journey-tests/01-nextjs-first-deploy.md, skills/journey-tests/02-feedback-bug.md
Root README updated with pnpm lint:skills and pnpm test:skills steps in local development workflow, plus agent skills installation command. Journey tests README explains manual test execution. Two journey tests document acceptance criteria: First Next.js Deploy covers end-to-end workflow with URL capture and JSON-based verification, Feedback Bug covers bug-filing with proper tool routing, environment collection, and user confirmation.

🎯 3 (Moderate) | ⏱️ ~20 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately summarizes the main change: adding a baseline for a skills cluster, which is the primary focus of this pull request.
Description check ✅ Passed The description is directly related to the changeset, explaining the addition of a Prisma CLI skills cluster with documentation, validation scripts, and journey tests.
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 feat/skills-integration
✨ Simplify code
  • Create PR with simplified code
  • Commit simplified code in branch feat/skills-integration

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.

@luanvdw luanvdw force-pushed the feat/skills-integration branch from 03f56c8 to 67cc581 Compare May 29, 2026 07:09
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: 4

🤖 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 `@packages/cli/src/shell/command-meta.ts`:
- Line 149: The command string "pnpm dlx skills@latest add
prisma/prisma-cli/skills#cli-v<version> --all" uses the inconsistent placeholder
<version>; update that literal to use the <cli-version> placeholder so it
matches other docs (use "pnpm dlx skills@latest add
prisma/prisma-cli/skills#cli-v<cli-version> --all" wherever that string
appears).

In `@packages/cli/tests/app.test.ts`:
- Line 152: The test assertion in packages/cli/tests/app.test.ts is still
expecting the example string with the old "<version>" placeholder; update the
expect on deployHelp.stderr to use "<cli-version>" to match the changed
placeholder in command-meta.ts (and ensure the test string exactly matches the
example output produced by the code that reads command-meta.ts).

In `@scripts/validate-skills.mjs`:
- Around line 134-147: validateSkillFile currently calls readFileSync and will
throw if a CLI-supplied file is missing/unreadable; update validateSkillFile to
wrap the readFileSync call in a try/catch and return a structured offence object
instead of throwing so runCheck can continue validating other files.
Specifically, in validateSkillFile catch errors from readFileSync and return {
file: relative(root, filePath), errors: [ `Unable to read file: ${err.message}`
] } (or a similar single-item errors array) so runCheck's
files.map(...).filter(...) still works and missing/unreadable files are reported
rather than aborting the whole process.

In `@scripts/validate-skills.test.mjs`:
- Line 83: The assertion in the test comparing offences[0].file to the hardcoded
"skills/bad-skill/SKILL.md" is OS-dependent and should be made
platform-agnostic: import or require Node's path and replace the literal
expected string with a normalized or joined path (e.g., build expected with
path.join("skills", "bad-skill", "SKILL.md") or compare
path.normalize(offences[0].file) to path.normalize(expected)), ensuring you
reference offences[0].file and the test assertion (strictEqual) so the
comparison works correctly on Windows and POSIX environments.
🪄 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: 62890be1-ea91-47e9-9df9-f983a2b3524e

📥 Commits

Reviewing files that changed from the base of the PR and between de5e017 and 03f56c8.

📒 Files selected for processing (16)
  • .gitignore
  • README.md
  • package.json
  • packages/cli/README.md
  • packages/cli/src/shell/command-meta.ts
  • packages/cli/tests/app.test.ts
  • scripts/validate-skills.mjs
  • scripts/validate-skills.test.mjs
  • skills/DEVELOPING.md
  • skills/README.md
  • skills/journey-tests/01-nextjs-first-deploy.md
  • skills/journey-tests/02-feedback-bug.md
  • skills/journey-tests/README.md
  • skills/prisma-cli-deploy-nextjs/SKILL.md
  • skills/prisma-cli-feedback/SKILL.md
  • skills/prisma-cli/SKILL.md

Comment thread packages/cli/src/shell/command-meta.ts Outdated
Comment thread packages/cli/tests/app.test.ts Outdated
Comment thread scripts/validate-skills.mjs
Comment thread scripts/validate-skills.test.mjs Outdated
@luanvdw luanvdw merged commit 4b1cb55 into main May 29, 2026
5 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