Agent skill

Staticphp Build Troubleshooting

by crazywhalecc in crazywhalecc/static-php-cli

Diagnose StaticPHP v3 failures. An agent skill from crazywhalecc/static-php-cli.

MITAuto-check passedTesting & QA

Install Staticphp Build Troubleshooting

skills CLI
$ npx skills add crazywhalecc/static-php-cli --skill staticphp-build-troubleshooting -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install crazywhalecc/static-php-cli staticphp-build-troubleshooting --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/crazywhalecc/static-php-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/staticphp-build-troubleshooting .claude/skills/staticphp-build-troubleshooting && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
staticphp-build-troubleshooting
GitHub stars
1.9k
Token cost
~814 tokens
SKILL.md length
329 words
Files
3 (incl. references)
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Diagnose StaticPHP v3 failures. An agent skill from crazywhalecc/static-php-cli.

  • Works in 4 steps: Capture the exact command, OS,… → Read the final terminal error first.… → If log files exist, inspect them in this… → …
  • Investigating build
  • SKILL.md covers Overview, First Pass, Diagnosis Rules and Repro Commands, plus 2 more sections
  • Calls php and cmake; needs GITHUB_TOKEN

What it does

Staticphp Build Troubleshooting is an agent skill from crazywhalecc/static-php-cli. Diagnose StaticPHP v3 failures. Use when investigating build, compile, linker, download, doctor, environment, CI, smoke-test, terminal output, spc.output.log, spc.shell.log, config.log, CMake logs, or user-provided error snippets from StaticPHP commands.

Its SKILL.md is about 810 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `agents/openai.yaml` and `references/log-triage.md`).

It sits in Testing & QA, covering QA and bug reports. It works with C++ and PHP. The repository describes itself as: Build standalone portable PHP binaries on Linux, macOS, Windows, with PHP project together, with popular extensions included. The licence is MIT.

When your agent uses it

  • Investigating build
  • Terminal output
  • User-provided error snippets from StaticPHP commands

Example prompts

  • “/staticphp-build-troubleshooting”

Requirements

  • A credential in GITHUB_TOKEN

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Capture the exact command, OS, architecture, PHP version, extensions/libs/targets, and whether the run used -v, -vv, or -vvv.
  2. Read the final terminal error first. StaticPHP prints module error info, failed package, failed stage, failed command, log paths, and…
  3. If log files exist, inspect them in this order
  4. Read references/log-triage.md for pattern matching, likely causes, and next checks.

What it can do on your machine

Read from SKILL.md and the folder at commit 1a765d9. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • php
    • cmake

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • GITHUB_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Staticphp Build Troubleshooting loads about 814 tokens when it runs, and up to ~2.5k if it reads all its reference files. Until then it costs about 72 tokens; SKILL.md has 329 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~72
When it runs · the whole SKILL.md, loaded when a task matches
~814
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from crazywhalecc/static-php-cli at commit 1a765d9, republished under its MIT licence (© crazywhalecc). 329 words, ~814 tokens.

Download SKILL.mdSave it as .claude/skills/staticphp-build-troubleshooting/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
staticphp-build-troubleshooting
description
Diagnose StaticPHP v3 failures. Use when investigating build, compile, linker, download, doctor, environment, CI, smoke-test, terminal output, spc.output.log, spc.shell.log, config.log, CMake logs, or user-provided error snippets from StaticPHP commands.

StaticPHP Build Troubleshooting

Overview

Use this skill to triage StaticPHP failures from the outside in: command and environment first, SPC module/stage metadata next, shell/config logs last. The goal is to isolate the failing package, stage, command, and root cause before editing code.

First Pass

  1. Capture the exact command, OS, architecture, PHP version, extensions/libs/targets, and whether the run used -v, -vv, or -vvv.
  2. Read the final terminal error first. StaticPHP prints module error info, failed package, failed stage, failed command, log paths, and extra log files when available.
  3. If log files exist, inspect them in this order:
    • log/spc.output.log: user-facing SPC messages and exception summary.
    • log/spc.shell.log: executed commands, working directories, env, stdout/stderr.
    • Extra logs named in the exception output: php-src.config.log, lib.<pkg>.console.log, lib.<pkg>.cmake-error.log, lib.<pkg>.cmake-configure.log, lib.<pkg>.cmake-output.log.
  4. Read references/log-triage.md for pattern matching, likely causes, and next checks.

Diagnosis Rules

  • Do not start by changing shared core code. Most failures are package metadata, environment, upstream source, dependency order, or platform flags.
  • Prefer evidence from the last failing command over earlier warnings.
  • When logs are long, search backward for Command exited, error:, undefined reference, not found, No package, CMake Error, configure: error, fatal error, Failed module, and Failed stage.
  • Use config.log and CMake logs for configure detection failures; use spc.shell.log for the actual command and env.
  • Be careful with rebuild suggestions. spc reset --with-download --yes is destructive to caches; ask before clearing caches unless the user explicitly asked.

Repro Commands

Use focused commands when reproducing:

bash
php bin/spc doctor -vvv
php bin/spc download --for-extensions="curl,openssl" --with-php=8.5 --parallel=4 --retry=3 -vvv
php bin/spc build:libs "openssl" -vvv
php bin/spc build:php "bcmath,openssl,curl" --build-cli -vvv
php bin/spc dev:lint-config

Choose the smallest command that still reaches the failing package.

Fix Direction

After finding the failing package/stage:

  • Package YAML issue: use $staticphp-package-maintenance, then edit config/pkg/* or config/artifact/*.
  • Build command or patch issue: inspect the package class under src/Package/*.
  • Environment issue: check doctor, toolchain classes, and config/pkg/tool/*.
  • Upstream download issue: check artifact type, regex, GitHub rate limiting, mirror behavior, and GITHUB_TOKEN.
  • Core exception/logging issue: inspect src/StaticPHP/Exception, src/StaticPHP/Runtime/Shell, or executor classes only after package-level causes are ruled out.

Resources

  • references/log-triage.md: log files, failure categories, search patterns, and likely fixes.

© crazywhalecc, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in .agents/skills/staticphp-build-troubleshooting of crazywhalecc/static-php-cli.

  • SKILL.md
  • agents/openai.yaml
  • references/log-triage.md

Open the folder on GitHubat commit 1a765d9

Compare with similar skills

Staticphp Build Troubleshooting next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Staticphp Build Troubleshooting compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Staticphp Build Troubleshooting this skillcrazywhalecc/static-php-cli1.9k—~814Automated safety check: PassMIT
PlotJuggler Live VerificationPlotJuggler/PlotJuggler6.2k—~956Automated safety check: PassMPL-2.0
Instructor QAcognesy/instructor-php328—~1.3kAutomated safety check: PassMIT
Build Northstarnordstjernen-web/northstar-browser116—~1.3kAutomated safety check: PassGPL-3.0
Engine Dev Loopscragnog/HOT-Step-CPP171—~6.1kAutomated safety check: NotesMIT
Detecting Command Injection Patternsjeremylongshore/tons-of-skills-marketplace2.8k—~1.3kAutomated safety check: PassMIT

Similar skills

  • PlotJuggler Live Verification

    PlotJuggler/PlotJuggler

    Confirms that a change to PlotJuggler 4 really works in the running app by proving the rebuild, launching with real data and measuring the result.

    6.2k GitHub stars~956 tokensUpdated 7 days ago
    Testing & QAAuto-check passed
  • Instructor QA

    cognesy/instructor-php

    Run multi-dimensional quality assurance for InstructorPHP. An agent skill from cognesy/instructor-php.

    328 GitHub stars~1.3k tokensUpdated 3 days ago
    Testing & QAAuto-check passed
  • Build Northstar

    nordstjernen-web/northstar-browser

    Configure, compile, and smoke-test a Meson-based C or C++ desktop browser on Linux, macOS, or Windows, and diagnose dependency, compiler, linker, runtime-library, build-directory, or…

    116 GitHub stars~1.3k tokensUpdated 2 days ago
    Testing & QAAuto-check passed
  • Engine Dev Loop

    scragnog/HOT-Step-CPP

    Safe edit-rebuild-test cycle for the HOT-Step C++ engine (dev-rebuild.bat, build script selection, stale-.obj recovery, smoke tests).

    171 GitHub stars~6.1k tokensUpdated yesterday
    Testing & QAAuto-check: notes
  • Detecting Command Injection Patterns

    jeremylongshore/tons-of-skills-marketplace

    Scan a source tree for command-injection vulnerable patterns: shell=True calls in Python subprocess, os.system / os.popen with interpolated strings, Node childprocess.exec with template literals…

    2.8k GitHub stars~1.3k tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Detecting Eval Exec Usage

    jeremylongshore/tons-of-skills-marketplace

    Scan a source tree for dynamic-code-execution APIs that an attacker can hijack: Python eval / exec / compile, JavaScript eval / Function() / setTimeout(string), Ruby eval / instanceeval / classeval…

    2.8k GitHub stars~1.1k tokensUpdated yesterday
    Testing & QAAuto-check passed

More from crazywhalecc/static-php-cli

  • Staticphp Documentation Sync

    crazywhalecc/static-php-cli

    Synchronize bilingual documentation when StaticPHP v3 user-facing or developer-facing documentation must change.

    1.9k GitHub stars~2.2k tokensUpdated yesterday
    Auto-check passed
  • Staticphp Package Maintenance

    crazywhalecc/static-php-cli

    Maintain StaticPHP v3 packages and artifacts. An agent skill from crazywhalecc/static-php-cli.

    1.9k GitHub stars~1k tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about Staticphp Build Troubleshooting

What does Staticphp Build Troubleshooting do?

Diagnose StaticPHP v3 failures. An agent skill from crazywhalecc/static-php-cli. Staticphp Build Troubleshooting is an agent skill from crazywhalecc/static-php-cli. Diagnose StaticPHP v3 failures.

When should I use Staticphp Build Troubleshooting?

Staticphp Build Troubleshooting fits situations like: investigating build; terminal output; user-provided error snippets from StaticPHP commands.

How do I install Staticphp Build Troubleshooting in Claude Code?

Run `npx skills add crazywhalecc/static-php-cli --skill staticphp-build-troubleshooting -a claude-code`. Or copy the skill folder (.agents/skills/staticphp-build-troubleshooting in crazywhalecc/static-php-cli) into .claude/skills/staticphp-build-troubleshooting in your project. Claude Code loads it when a task matches its description.

How do I install Staticphp Build Troubleshooting in Codex?

Run `npx skills add crazywhalecc/static-php-cli --skill staticphp-build-troubleshooting -a codex`. Or copy the skill folder (.agents/skills/staticphp-build-troubleshooting in crazywhalecc/static-php-cli) into .agents/skills/staticphp-build-troubleshooting in your project. Codex loads it when a task matches its description.

Can I use Staticphp Build Troubleshooting in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add crazywhalecc/static-php-cli --skill staticphp-build-troubleshooting -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/staticphp-build-troubleshooting, .gemini/skills/staticphp-build-troubleshooting, .github/skills/staticphp-build-troubleshooting and .opencode/skills/staticphp-build-troubleshooting in your project.

What does Staticphp Build Troubleshooting need to run?

Going by SKILL.md and its folder, Staticphp Build Troubleshooting needs the command-line tools its instructions call (php and cmake) and credentials named GITHUB_TOKEN. Our summary lists: A credential in GITHUB_TOKEN.

Does Staticphp Build Troubleshooting access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Staticphp Build Troubleshooting safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Staticphp Build Troubleshooting use?

Staticphp Build Troubleshooting is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Staticphp Build Troubleshooting use?

About 814 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.7k tokens, read only when the agent opens those files.

What are the alternatives to Staticphp Build Troubleshooting?

Skills that share tags, products or a category with Staticphp Build Troubleshooting: PlotJuggler Live Verification (PlotJuggler/PlotJuggler, 6.2k stars), Instructor QA (cognesy/instructor-php, 328 stars), Build Northstar (nordstjernen-web/northstar-browser, 116 stars) and Engine Dev Loop (scragnog/HOT-Step-CPP, 171 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Staticphp Build Troubleshooting?

crazywhalecc (a GitHub user) maintains it in crazywhalecc/static-php-cli, which has 1,949 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 7, 2026.

Source: crazywhalecc/static-php-cli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.