{
  "schemaVersion": "1.0",
  "item": {
    "slug": "buildwright",
    "name": "Buildwright",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/raunakkathuria/buildwright",
    "canonicalUrl": "https://clawhub.ai/raunakkathuria/buildwright",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/buildwright",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=buildwright",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/buildwright"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/buildwright",
    "agentPageUrl": "https://openagent3.xyz/skills/buildwright/agent",
    "manifestUrl": "https://openagent3.xyz/skills/buildwright/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/buildwright/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Buildwright",
        "body": "Spec-driven autonomous development. Humans approve intent; agents handle everything else."
      },
      {
        "title": "What this skill does",
        "body": "When activated, Buildwright directs the agent to:\n\nRead your codebase and steering documents\nWrite a one-page spec (docs/specs/[feature]/spec.md)\nStop for human approval — unless BUILDWRIGHT_AUTO_APPROVE=true\nImplement the feature with TDD\nRun quality gates: typecheck, lint, test, build\nRun optional security scans (if semgrep / gitleaks / trufflehog are installed)\nRun a Staff Engineer prompt-based code review\nCommit, push, and open a PR via gh"
      },
      {
        "title": "Credentials (required)",
        "body": "CredentialPurposeScopeHow to provideGITHUB_TOKENPush commits and open PRs via ghrepo scope (read/write)export GITHUB_TOKEN=ghp_... or configure in OpenClaw config under skills.entries.buildwright.apiKey\n\nThe token must have repo scope to push branches and create pull requests. For minimal privilege, use a fine-grained personal access token scoped to a single repository with \"Contents: Read and write\" and \"Pull requests: Read and write\" permissions.\n\nAlternatively, if you use SSH for git push, the GITHUB_TOKEN is still needed for gh pr create. You can use gh auth login to authenticate the GitHub CLI separately."
      },
      {
        "title": "Binaries (required)",
        "body": "BinaryPurposegitCommits and pushesghOpens PRs via GitHub CLI"
      },
      {
        "title": "Optional tools",
        "body": "BinaryPurposesemgrepSAST security scangitleaks / trufflehogSecrets detection"
      },
      {
        "title": "Agent Personas (prompt-based, no binaries)",
        "body": "Staff Engineer and Security Engineer are prompt-engineering personas — instructions loaded from .buildwright/agents/ files in the workspace. They are not external tools or binaries. The agent adopts these personas to review specs and code using defined criteria and confidence thresholds. These files contain only prompt instructions and review checklists — no secrets or credentials."
      },
      {
        "title": "BUILDWRIGHT_AUTO_APPROVE (optional, not a credential)",
        "body": "This is an optional boolean flag that controls whether the agent waits for human approval at the spec stage. It is not a secret and not declared in requires.env because it is not required to run the skill.\n\nValueBehaviorNot setInteractive (default) — stops and waits for \"approved\" before buildingfalseInteractive — same as defaulttrueAutonomous — commits spec to git (audit trail) and proceeds without waiting\n\nRecommendation for first use: Leave BUILDWRIGHT_AUTO_APPROVE unset until you have reviewed a few specs and are comfortable with the workflow. Start with interactive mode in a sandbox repository to observe behavior before enabling autonomous commits and PRs."
      },
      {
        "title": "/bw-new-feature <description>",
        "body": "Full pipeline for new features. Auto-detects greenfield vs existing projects.\n\n/bw-new-feature \"Add OAuth2 login\"\n\nFlow: Detect (greenfield or existing?) → Research → Spec → Staff Engineer validates → Human approves → TDD build → Verify → Security scan → Code review → PR\n\nArtifacts produced:\n\ndocs/specs/[feature]/research.md — what the agent found in your codebase\ndocs/specs/[feature]/spec.md — implementation plan with approaches considered"
      },
      {
        "title": "/bw-claw <feature>",
        "body": "Multi-agent pipeline using the Claw Architecture. Architect decomposes the feature into domain-specific claw tasks (UI, API, DB), defines interface contracts, and coordinates execution.\n\n/bw-claw \"Add profile photo upload for team members\"\n\nFlow: Architect analyzes → Decomposes into claw tasks → Defines interface contract → Claws execute per domain (TDD) → Architect integrates → Buildwright quality gates → PR\n\nBest for: Features that cross domain boundaries (e.g., need DB schema + API endpoint + UI component).\n\nArtifacts produced:\n\ndocs/specs/[feature]/claw-plan.md — decomposition plan with interface contracts\ndocs/specs/[feature]/claw-[domain].md — per-claw execution report"
      },
      {
        "title": "/bw-quick <task>",
        "body": "Fast path for bug fixes and small tasks (<2 hrs). No spec, no approval step.\n\n/bw-quick \"Fix the login timeout bug\""
      },
      {
        "title": "/bw-ship [message]",
        "body": "Quality pipeline for existing work: verify → security → review → PR.\n\n/bw-ship \"feat(auth): add OAuth2 support\""
      },
      {
        "title": "/bw-verify",
        "body": "Quick checks only: typecheck → lint → test → build."
      },
      {
        "title": "/bw-analyse",
        "body": "Analyse an existing codebase and write structured docs to .buildwright/codebase/. Updates tech.md with the discovered stack and commands. Run this first on any brownfield project to give every subsequent session real context.\n\n/bw-analyse\n\nProduces: STACK.md, ARCHITECTURE.md, CONVENTIONS.md, CONCERNS.md under .buildwright/codebase/."
      },
      {
        "title": "/bw-help",
        "body": "Show all available commands."
      },
      {
        "title": "Failure Behavior",
        "body": "If any gate fails after retries, the agent commits completed work, pushes, and opens a PR with a structured failure report. It does not leave orphaned branches or silent failures."
      },
      {
        "title": "Retry Policy",
        "body": "GateRetriesRationaleVerify (typecheck, lint, test, build)2xFixable by the agentSecurity scanNoneRequires human judgmentCode reviewNoneArchitectural decisions need humans"
      },
      {
        "title": "Security Considerations",
        "body": "This skill performs autonomous code changes, commits, and pull requests. Understand what it does before enabling it on repositories with sensitive or production code.\n\nWhat the skill reads: Your repository source code, .buildwright/agents/ persona files (prompt instructions only, no secrets), and .buildwright/steering/ context files.\n\nWhat the skill writes: Spec files under docs/specs/, source code changes, git commits on feature branches, and pull requests via gh.\n\nWhat the skill does NOT do: It does not modify .env files, access secrets stores, run destructive git operations (force push, reset), or merge PRs. All changes go to feature branches with PRs for human review.\n\nRecommended setup for first use:\n\nStart with a fork or sandbox repository, not production code\nLeave BUILDWRIGHT_AUTO_APPROVE unset (interactive mode) to review specs before builds\nUse a fine-grained GitHub token scoped to a single repository with minimal permissions\nRotate tokens regularly and revoke when no longer needed\nReview generated PRs before merging — the skill creates PRs, it does not merge them"
      },
      {
        "title": "More Information",
        "body": "Full documentation, source code, and setup instructions: https://github.com/raunakkathuria/buildwright"
      }
    ],
    "body": "Buildwright\n\nSpec-driven autonomous development. Humans approve intent; agents handle everything else.\n\nWhat this skill does\n\nWhen activated, Buildwright directs the agent to:\n\nRead your codebase and steering documents\nWrite a one-page spec (docs/specs/[feature]/spec.md)\nStop for human approval — unless BUILDWRIGHT_AUTO_APPROVE=true\nImplement the feature with TDD\nRun quality gates: typecheck, lint, test, build\nRun optional security scans (if semgrep / gitleaks / trufflehog are installed)\nRun a Staff Engineer prompt-based code review\nCommit, push, and open a PR via gh\nRequirements\nCredentials (required)\nCredential\tPurpose\tScope\tHow to provide\nGITHUB_TOKEN\tPush commits and open PRs via gh\trepo scope (read/write)\texport GITHUB_TOKEN=ghp_... or configure in OpenClaw config under skills.entries.buildwright.apiKey\n\nThe token must have repo scope to push branches and create pull requests. For minimal privilege, use a fine-grained personal access token scoped to a single repository with \"Contents: Read and write\" and \"Pull requests: Read and write\" permissions.\n\nAlternatively, if you use SSH for git push, the GITHUB_TOKEN is still needed for gh pr create. You can use gh auth login to authenticate the GitHub CLI separately.\n\nBinaries (required)\nBinary\tPurpose\ngit\tCommits and pushes\ngh\tOpens PRs via GitHub CLI\nOptional tools\nBinary\tPurpose\nsemgrep\tSAST security scan\ngitleaks / trufflehog\tSecrets detection\nAgent Personas (prompt-based, no binaries)\n\nStaff Engineer and Security Engineer are prompt-engineering personas — instructions loaded from .buildwright/agents/ files in the workspace. They are not external tools or binaries. The agent adopts these personas to review specs and code using defined criteria and confidence thresholds. These files contain only prompt instructions and review checklists — no secrets or credentials.\n\nConfiguration\nBUILDWRIGHT_AUTO_APPROVE (optional, not a credential)\n\nThis is an optional boolean flag that controls whether the agent waits for human approval at the spec stage. It is not a secret and not declared in requires.env because it is not required to run the skill.\n\nValue\tBehavior\nNot set\tInteractive (default) — stops and waits for \"approved\" before building\nfalse\tInteractive — same as default\ntrue\tAutonomous — commits spec to git (audit trail) and proceeds without waiting\n\nRecommendation for first use: Leave BUILDWRIGHT_AUTO_APPROVE unset until you have reviewed a few specs and are comfortable with the workflow. Start with interactive mode in a sandbox repository to observe behavior before enabling autonomous commits and PRs.\n\nCommands\n/bw-new-feature <description>\n\nFull pipeline for new features. Auto-detects greenfield vs existing projects.\n\n/bw-new-feature \"Add OAuth2 login\"\n\n\nFlow: Detect (greenfield or existing?) → Research → Spec → Staff Engineer validates → Human approves → TDD build → Verify → Security scan → Code review → PR\n\nArtifacts produced:\n\ndocs/specs/[feature]/research.md — what the agent found in your codebase\ndocs/specs/[feature]/spec.md — implementation plan with approaches considered\n/bw-claw <feature>\n\nMulti-agent pipeline using the Claw Architecture. Architect decomposes the feature into domain-specific claw tasks (UI, API, DB), defines interface contracts, and coordinates execution.\n\n/bw-claw \"Add profile photo upload for team members\"\n\n\nFlow: Architect analyzes → Decomposes into claw tasks → Defines interface contract → Claws execute per domain (TDD) → Architect integrates → Buildwright quality gates → PR\n\nBest for: Features that cross domain boundaries (e.g., need DB schema + API endpoint + UI component).\n\nArtifacts produced:\n\ndocs/specs/[feature]/claw-plan.md — decomposition plan with interface contracts\ndocs/specs/[feature]/claw-[domain].md — per-claw execution report\n/bw-quick <task>\n\nFast path for bug fixes and small tasks (<2 hrs). No spec, no approval step.\n\n/bw-quick \"Fix the login timeout bug\"\n\n/bw-ship [message]\n\nQuality pipeline for existing work: verify → security → review → PR.\n\n/bw-ship \"feat(auth): add OAuth2 support\"\n\n/bw-verify\n\nQuick checks only: typecheck → lint → test → build.\n\n/bw-analyse\n\nAnalyse an existing codebase and write structured docs to .buildwright/codebase/. Updates tech.md with the discovered stack and commands. Run this first on any brownfield project to give every subsequent session real context.\n\n/bw-analyse\n\n\nProduces: STACK.md, ARCHITECTURE.md, CONVENTIONS.md, CONCERNS.md under .buildwright/codebase/.\n\n/bw-help\n\nShow all available commands.\n\nFailure Behavior\n\nIf any gate fails after retries, the agent commits completed work, pushes, and opens a PR with a structured failure report. It does not leave orphaned branches or silent failures.\n\nRetry Policy\nGate\tRetries\tRationale\nVerify (typecheck, lint, test, build)\t2x\tFixable by the agent\nSecurity scan\tNone\tRequires human judgment\nCode review\tNone\tArchitectural decisions need humans\nSecurity Considerations\n\nThis skill performs autonomous code changes, commits, and pull requests. Understand what it does before enabling it on repositories with sensitive or production code.\n\nWhat the skill reads: Your repository source code, .buildwright/agents/ persona files (prompt instructions only, no secrets), and .buildwright/steering/ context files.\n\nWhat the skill writes: Spec files under docs/specs/, source code changes, git commits on feature branches, and pull requests via gh.\n\nWhat the skill does NOT do: It does not modify .env files, access secrets stores, run destructive git operations (force push, reset), or merge PRs. All changes go to feature branches with PRs for human review.\n\nRecommended setup for first use:\n\nStart with a fork or sandbox repository, not production code\nLeave BUILDWRIGHT_AUTO_APPROVE unset (interactive mode) to review specs before builds\nUse a fine-grained GitHub token scoped to a single repository with minimal permissions\nRotate tokens regularly and revoke when no longer needed\nReview generated PRs before merging — the skill creates PRs, it does not merge them\nMore Information\n\nFull documentation, source code, and setup instructions: https://github.com/raunakkathuria/buildwright"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/raunakkathuria/buildwright",
    "publisherUrl": "https://clawhub.ai/raunakkathuria/buildwright",
    "owner": "raunakkathuria",
    "version": "0.0.3",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/buildwright",
    "downloadUrl": "https://openagent3.xyz/downloads/buildwright",
    "agentUrl": "https://openagent3.xyz/skills/buildwright/agent",
    "manifestUrl": "https://openagent3.xyz/skills/buildwright/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/buildwright/agent.md"
  }
}