feat: add rstest-cdp skill

Author: fi3ework

.gitignore

@@ -0,0 +1,134 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+# macOS
+.DS_Store
+**/.DS_Store
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+web_modules/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional stylelint cache
+.stylelintcache
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variable files
+.env
+.env.*
+!.env.example
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+out
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and not Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public
+
+# vuepress build output
+.vuepress/dist
+
+# vuepress v2.x temp and cache directory
+.temp
+.cache
+
+# Sveltekit cache directory
+.svelte-kit/
+
+# Docusaurus cache and generated files
+.docusaurus
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# Firebase cache directory
+.firebase/
+
+# TernJS port file
+.tern-port
+
+# Stores VSCode versions used for testing VSCode extensions
+.vscode-test
+
+# yarn v3
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/sdks
+!.yarn/versions
+

.nvmrc

@@ -0,0 +1 @@
+v24

AGENTS.md

@@ -0,0 +1,89 @@
+# AGENTS.md
+
+This file provides guidance to AI coding agents working with code in this repository.
+
+## Repository Overview
+
+A collection of Agent Skills for the Rspack ecosystem (Rspack, Rsbuild, Rslib, Rstest, Rsdoctor). Skills are packaged instructions and scripts that extend agent capabilities for debugging, profiling, and development workflows.
+
+## Creating a New Skill
+
+### Directory Structure
+
+```
+skills/
+  {skill-name}/           # kebab-case directory name
+    SKILL.md              # Required: skill definition with YAML frontmatter
+    scripts/              # Optional: executable scripts (.js, .cjs, .sh)
+    references/           # Optional: detailed documentation loaded on-demand
+    assets/               # Optional: templates, images, data files
+```
+
+### Naming Conventions
+
+- **Skill directory**: `kebab-case` (e.g., `rspack-debugging`, `rstest-cdp`)
+- **SKILL.md**: Always uppercase, always this exact filename
+- **Scripts**: `snake_case.js` or `snake_case.cjs` (e.g., `analyze_trace.js`, `setup_debug_deps.cjs`)
+
+### SKILL.md Format
+
+```markdown
+---
+name: { skill-name }
+description:
+  {
+    What the skill does AND when to use it. Include trigger phrases and error messages that should activate this skill.,
+  }
+compatibility:
+  { Optional: environment requirements like Node version, CLI tools, etc. }
+---
+
+# {Skill Title}
+
+## When to Use This Skill
+
+{Clear trigger conditions — error messages, scenarios, user requests}
+
+## Workflow
+
+{Numbered steps explaining how to use the skill}
+
+## Detailed Guides
+
+{Links to reference files for progressive disclosure}
+
+## Troubleshooting
+
+{Common issues and solutions}
+```
+
+### Best Practices for Context Efficiency
+
+Skills use progressive disclosure — only name and description load at startup. The full `SKILL.md` loads when the agent decides the skill is relevant.
+
+- **Keep SKILL.md under 500 lines** — put detailed guides in `references/` directory
+- **Write specific descriptions** — include exact error messages and trigger phrases
+- **One level deep references** — link directly from SKILL.md to supporting files
+- **Prefer scripts over inline code** — script execution doesn't consume context (only output does)
+- **No time-sensitive information** — avoid dates or version-specific instructions that will become stale
+
+### Script Requirements
+
+- Use CommonJS (`require`/`module.exports`) for `.cjs` files
+- Include clear usage help: `console.error('Usage: node script.js <args>')`
+- Handle errors explicitly with actionable messages
+- Use emoji prefixes for user-facing logs: `📍`, `✅`, `❌`, `⚠️`, `👉`
+- Document magic constants: `const MIN_VERSION = '1.3.14'; // First version with debug symbols`
+
+### Validating Skills
+
+Use the [skills-ref](https://github.com/agentskills/agentskills/tree/main/skills-ref) library:
+
+```bash
+npx skills-ref validate ./skills/{skill-name}
+```
+
+## Resources
+
+- [Agent Skills Specification](https://agentskills.io/specification)
+- [Skill Authoring Best Practices](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices)

biome.json

@@ -0,0 +1,29 @@
+{
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "files": {
+    "ignore": []
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 100
+  },
+  "linter": {
+    "enabled": false
+  },
+  "organizeImports": {
+    "enabled": false
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "single",
+      "semicolons": "always",
+      "trailingCommas": "all"
+    }
+  }
+}

e2e/cdp/fixtures/basic-no-debug/package.json

@@ -0,0 +1,9 @@
+{
+  "private": true,
+  "name": "@agent-skills/cdp-fixture-basic-no-debug",
+  "type": "module",
+  "version": "1.0.0",
+  "devDependencies": {
+    "@rstest/core": "^0.8.2"
+  }
+}

e2e/cdp/fixtures/basic-no-debug/rstest.config.ts

@@ -0,0 +1,13 @@
+import { defineConfig } from '@rstest/core';
+
+export default defineConfig({
+  root: __dirname,
+  tools: {
+    rspack: (config) => {
+      config.devtool = 'inline-source-map';
+    },
+  },
+  dev: {
+    writeToDisk: true,
+  },
+});

e2e/cdp/fixtures/basic-no-debug/src/math.ts

@@ -0,0 +1,13 @@
+export const summarizeScores = (scores: number[]) => {
+  const total = scores.reduce((sum, value) => sum + value, 0);
+  const average = scores.length ? total / scores.length : 0;
+  const weightedTotal = total + average * 0.25;
+  const label = `${scores.length}-scores`;
+
+  return {
+    total,
+    average,
+    weightedTotal,
+    label,
+  };
+};

e2e/cdp/fixtures/basic-no-debug/src/profile.ts

@@ -0,0 +1,15 @@
+export const formatUser = (name: string, role = 'member') => {
+  const trimmed = name.trim();
+  const [firstName = '', lastName = ''] = trimmed.split(' ');
+  const normalized = `${firstName.toLowerCase()}-${lastName.toLowerCase()}`;
+  const displayName = `${firstName} ${lastName}`.trim();
+
+  return {
+    trimmed,
+    firstName,
+    lastName,
+    normalized,
+    displayName,
+    role,
+  };
+};

e2e/cdp/fixtures/basic-no-debug/test/combined.test.ts

@@ -0,0 +1,20 @@
+import { describe, expect, it } from '@rstest/core';
+import { summarizeScores } from '../src/math';
+import { formatUser } from '../src/profile';
+
+describe('combined tests', () => {
+  it('formats user profile', () => {
+    const profile = formatUser('Ada Lovelace', 'admin');
+
+    expect(profile.displayName).toBe('Ada Lovelace');
+    expect(profile.normalized).toBe('ada-lovelace');
+  });
+
+  it('summarizes scores', () => {
+    const result = summarizeScores([12, 18, 30]);
+
+    expect(result.total).toBe(60);
+    expect(result.average).toBe(20);
+    expect(result.weightedTotal).toBe(65);
+  });
+});

e2e/cdp/fixtures/basic-no-debug/test/math.test.ts

@@ -0,0 +1,12 @@
+import { describe, expect, it } from '@rstest/core';
+import { summarizeScores } from '../src/math';
+
+describe('score summary', () => {
+  it('computes totals', () => {
+    const result = summarizeScores([12, 18, 30]);
+
+    expect(result.total).toBe(60);
+    expect(result.average).toBe(20);
+    expect(result.weightedTotal).toBe(65);
+  });
+});