setup-task-to-pr

Setup Task to PR

Turn the generic Supatest AI task-to-PR skill suite into project-local skills that know the current repository's commands, validation gates, review rules, artifact paths, surfaces, and operational constraints.

This skill creates or updates local skills in the target project. It does not write a single central profile. Each configured skill should read like it was written for that project.

When Not to Use

• Do not use for executing an implementation task. Use task-to-pr.
• Do not use for only committing current changes. Use commit.
• Do not use for only testing a finished feature. Use test-feature.
• Do not use for a one-off explanation of the workflow; explain the installed skills instead.

Target Output

Create or update project-local skills under the first supported local skills directory:

1. .agents/skills/<skill-name>/SKILL.md
2. .claude/skills/<skill-name>/SKILL.md
3. .codex/skills/<skill-name>/SKILL.md

Prefer .agents/skills when the repo already uses it or has no established skill directory. Use the directory the project already documents if one exists.

Configure this stack by default:

• task-to-pr
• test-feature
• automate-e2e-tests
• agent-browser
• commit
• review-pr

Create surface-specific testing skills only when validation machinery truly differs:

• test-web-feature
• test-mobile-feature
• test-ios-feature
• test-android-feature
• test-api-feature
• test-desktop-feature
• integration-test
• contract-test
• ci-failure-triage

Split by tooling and evidence requirements, not by product labels. For example, a web app and PWA that both use Playwright can share test-feature; native iOS and Android apps usually deserve separate configured skills.

Phase 1 - Inspect the Repository

Read the repo before asking questions.

Run focused discovery commands:

pwd
git status --short
rg --files -g 'AGENTS.md' -g 'CLAUDE.md' -g 'README*' -g 'CONTRIBUTING*' -g 'package.json' -g 'pnpm-workspace.yaml' -g 'turbo.json' -g 'nx.json' -g 'vite.config.*' -g 'next.config.*' -g 'playwright.config.*' -g 'cypress.config.*' -g 'pom.xml' -g 'build.gradle*' -g 'settings.gradle*' -g 'pyproject.toml' -g 'go.mod' -g '*.xcodeproj' -g '*.xcworkspace' -g 'Package.swift'
find . -maxdepth 3 -type d \( -name e2e -o -name tests -o -name test -o -name specs -o -name __tests__ \) 2>/dev/null | sort

Read the highest-signal files:

• Root agent or contributor instructions.
• Package manager scripts.
• Test configuration.
• PR template if present.
• Existing local skills if present.
• Mobile, desktop, API, or deployment docs when the repo suggests those surfaces.

Infer what is obvious before asking the team. Do not ask questions that can be answered from files.

Phase 2 - Interview the Team

Ask only questions whose answers change the generated skills. Group questions so the user can answer in one pass.

Required questions:

1. What surfaces should this workflow support: web, PWA, API, iOS, Android, React Native, desktop, CLI, library, data pipeline, infrastructure, or monorepo?
2. Which validation lanes exist for this project: lint, format, typecheck, compile, unit tests, component tests, integration tests, contract tests, E2E tests, feature validation, build/package, security scan, accessibility check, performance check, mobile simulator tests, or other checks?
3. What exact command proves each lane, and what is the focused command pattern for changed files, packages, apps, or test names?
4. Which lanes are required for each change type: docs, UI, API, shared logic, schema/database, auth/security, mobile, desktop, CLI, infrastructure, dependencies, or config?
5. What commands are expensive, flaky, destructive, production-affecting, or require approval?
6. How should local feature validation work: app URL, auth path, test users, seed data, browser, device, simulator, emulator, or API client?
7. What evidence should a completed task produce: screenshots, video, HTML report, test logs, coverage, trace, accessibility output, deployment links, or ticket comments?
8. What does the PR body require: ticket link, problem, changes, tests, screenshots, risk, rollback, compatibility, security, accessibility, performance, observability, or release notes?
9. What branch, commit, and push rules apply: branch prefix, ticket ID in branch, conventional commits, signed commits, squash policy, no-push policy, or review before push?
10. What enterprise constraints apply: regulated data, client isolation, approval gates, no production access, migration guardrails, secrets policy, audit evidence, or security review?

Ask follow-up questions only for ambiguity that would make the skills unsafe or useless. If the user cannot answer, encode a runtime confirmation step in the relevant skill instead of guessing.

Phase 3 - Choose the Skill Topology

Use this decision table:

Situation	Configure
One primary product surface	test-feature only
Web and PWA share browser tooling	test-feature with surface sections
Web and native mobile have different tooling	test-web-feature plus test-mobile-feature or platform-specific skills
iOS and Android use different commands/devices	test-ios-feature and test-android-feature
API-only service	test-api-feature; keep agent-browser only if docs/admin UI exist
Library/package	no browser testing skill unless examples/docs UI exists
Monorepo with independent apps	task-to-pr routes by touched surface; split test skills when commands differ

Keep the first configuration small enough to use. Add split skills when the team names a concrete command, tool, or evidence requirement that differs by surface.

Create deep validation-lane skills such as integration-test, contract-test, migration-validate, or ci-failure-triage only when the lane has repeatable procedure beyond a command: fixture setup, environment routing, failure classification, retries, artifact parsing, or team-specific escalation.

Phase 4 - Write Project-Local Skills

For each local skill, write a complete coherent SKILL.md. Do not append a vague "Project Overrides" section to a generic body.

Each skill must include:

• Frontmatter with name, description, and optional argument-hint.
• Clear trigger and anti-trigger behavior.
• Project contract: stack, surfaces, and assumptions.
• Exact commands and paths, with fallbacks only where needed.
• Validation lanes with command, scope, required change types, focused-run pattern, full-run pattern, and skip/escalation rules.
• Required evidence and report location.
• Failure handling with concrete next actions.
• Self-improvement instruction: if the workflow proves stale, patch the local skill.

Use these specialization rules:

• task-to-pr: orchestrates requirement, planning, implementation, validation lanes, testing evidence, commit, self-review, push, and PR.
• test-feature: validates finished user-facing behavior and writes a feature validation report.
• automate-e2e-tests: turns validated behavior into durable regression coverage using the project's E2E, integration, contract, API, browser, or mobile framework.
• agent-browser: teaches browser mechanics for the available browser automation tool. If the Agent Browser CLI is standard, keep it thin and call agent-browser skills get core --full for current instructions.
• commit: encodes the project's commit, branch, staging, signing, and push policy.
• review-pr: encodes local review dimensions, severity model, and domain risks.

Configured task-to-pr skills should include a project-specific validation matrix. Use this shape unless the repo already has a better one:

## Validation Gates

| Change Type | Required Lanes | Focused Commands | Full Commands | Notes |
|---|---|---|---|---|
| Docs | docs lint if available | ... | ... | ... |
| UI | lint, typecheck, unit/component, feature validation | ... | ... | ... |
| Shared logic | lint, typecheck, unit, affected consumers | ... | ... | ... |
| API | lint, typecheck/compile, unit, integration/contract | ... | ... | ... |
| Schema/database | migration validation, integration, rollback notes | ... | ... | ... |
| Auth/security | unit, integration, feature validation, security review | ... | ... | ... |
| Mobile | lint/typecheck/compile, unit, simulator/device checks | ... | ... | ... |

Do not split lint, unit, or integration into separate public skills by default. Encode them as first-class validation lanes inside the configured project skills. Create separate local skills only when the lane has deep repeatable procedure, such as flaky-test triage, CI failure diagnosis, migration validation, or mobile simulator setup.

Phase 5 - Preserve Upstream Provenance

Add a short provenance section near the bottom of generated local skills:

## Source

Generated from Supatest AI supa-skills `<skill-name>` v<version> by `setup-task-to-pr`.
Project-specific behavior is intentionally local to this repository.

When updating an existing configured skill, preserve useful local knowledge. Replace stale commands, remove contradictions, and keep the source/version current.

When reconfiguring an existing project:

1. Read each existing local skill before editing.
2. Preserve local domain knowledge, client rules, incident learnings, and hard-won failure handling.
3. Replace stale generic sections and incorrect commands.
4. Report any local section that was removed or substantially rewritten.
5. Never overwrite project-specific rules with marketplace defaults without naming the tradeoff.

Phase 6 - Validate

After writing skills:

1. Confirm every generated skill has valid frontmatter starting on line 1.
2. Confirm each name matches its directory.
3. Confirm descriptions are specific enough to trigger correctly and not so broad that they steal unrelated tasks.
4. Run a syntax check that fits the repository:

   find .agents/skills .claude/skills .codex/skills -name SKILL.md 2>/dev/null | sort
   

5. Read each generated skill once after writing to catch contradictions.
6. If the repo has a skill validator, run it.

Do not run destructive project commands during configuration. Only run read-only inspection and safe validation unless the user explicitly approves more.

Final Report

Report:

• Local skill directory used.
• Skills created or updated.
• Any split testing skills created and why.
• Commands and gates configured.
• Questions left for runtime confirmation.
• Any risks, missing credentials, unavailable tooling, or project docs that should be improved.

Self-Improvement

If this configurator misses a common project shape, validation lane, local-skill location, or enterprise constraint during setup, patch this skill before closing.