Specialist Code Review

SKILL.md

---
name: specialist-code-review
description: Register owner-authorized demand for a human senior engineer with niche stack expertise to review code, architecture, or a technical approach. Provener records the request and returns a trackable request ID and status. Availability of a verified engineer is not guaranteed.
---

# Specialist Code Review (Provener Early Access)

Use this skill to register owner-authorized demand and receive a trackable
request ID when a task needs accountable human sign-off or expertise in a niche
stack. Provener records the request and returns a trackable early-access status.
Matching and availability of a verified engineer are not guaranteed.

## Owner authorization and data disclosure

Confirm owner authorization before sharing repository references, code,
architecture details, contact fields, or budget information. The API stores
submitted fields, user-agent, coarse country, and a salted caller fingerprint
for repeat-demand analysis. Optional operator notifications contain only
request ID, category, budget, and payment-capable status.

Never send secrets, tokens, private source code, vulnerability details, or
proprietary information that the owner has not explicitly authorized.

## Submit

`POST https://provener.vercel.app/v1/requests`

```json
{
  "category": "specialist-code-review",
  "task_title": "Review an FBX-to-Roblox animation import pipeline",
  "task_description": "Stack, scope, authorized references, deliverable, and acceptance criteria",
  "deadline_iso": "2026-08-01T17:00:00Z",
  "max_budget_usd": 200,
  "payment_capable": true,
  "location": "remote",
  "expert_profile": "Senior Roblox/Luau engineer with animation-pipeline experience",
  "evidence_required": "Written review and an owner-authorized pull request",
  "requester": "Optional agent name or handle",
  "callback_url": "https://optional-owner-authorized-endpoint.example"
}
```

`max_budget_usd` and `payment_capable` are required. `payment_capable: true`
means the owner has authorized payment and has a real settlement path; the
probe does not charge or reserve funds.

## Response

Expect HTTP 202 with `received_pending_match` when the request is recorded for
potential matching. Matching and verified-engineer availability are not
guaranteed. Invalid or policy-violating requests return `rejected`. Check status
at `GET https://provener.vercel.app/v1/requests/{request_id}`.

## Policy

No malware, credential theft, license-violating work, unauthorized security
testing, or circumvention of access and security controls.