Agent skill

Staticphp Package Maintenance

by crazywhalecc in crazywhalecc/static-php-cli

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

MITAuto-check passed

Install Staticphp Package Maintenance

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

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

GitHub CLI
$ gh skill install crazywhalecc/static-php-cli staticphp-package-maintenance --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-package-maintenance .claude/skills/staticphp-package-maintenance && 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-package-maintenance
GitHub stars
1.9k
Token cost
~1k tokens
SKILL.md length
389 words
Files
4 (incl. references)
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 5 steps: Identify the package kind and exact name. → Search for the closest existing package… → Read references/package-reference.md… → …
  • Validating config under config/pkg
  • SKILL.md covers Overview, Quick Workflow, Editing Rules and Common Task Paths, plus 1 more section
  • Calls rg, composer and php

What it does

Staticphp Package Maintenance is an agent skill from crazywhalecc/static-php-cli. Maintain StaticPHP v3 packages and artifacts. Use when adding, modifying, reviewing, or validating config under config/pkg or config/artifact; package classes under src/Package; extension/library/target/tool dependencies; PHP configure args; build hooks; package metadata; or related tests and docs.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `agents/openai.yaml`, `references/build-class-patterns.md` and `references/package-reference.md`).

It works with 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

  • Validating config under config/pkg
  • Config/artifact
  • Package classes under src/Package
  • Extension/library/target/tool dependencies

Example prompts

  • “/staticphp-package-maintenance”

Workflow steps

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

  1. Identify the package kind and exact name.
  2. Search for the closest existing package before designing anything new.
  3. Read references/package-reference.md when changing YAML fields, artifact definitions, package naming, dependencies, platform suffixes, or…
  4. Read references/build-class-patterns.md when PHP build logic, attributes, lifecycle hooks, custom configure args, source patching, or…
  5. Validate narrowly, then broadly if risk warrants it.

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:

    • rg
    • composer
    • php

    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 no API keys, tokens, secrets or passwords.

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

Context cost

Staticphp Package Maintenance loads about 1k tokens when it runs, and up to ~3.9k if it reads all its reference files. Until then it costs about 82 tokens; SKILL.md has 389 words of instructions outside code blocks.

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

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). 389 words, ~1,017 tokens.

Download SKILL.mdSave it as .claude/skills/staticphp-package-maintenance/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
staticphp-package-maintenance
description
Maintain StaticPHP v3 packages and artifacts. Use when adding, modifying, reviewing, or validating config under config/pkg or config/artifact; package classes under src/Package; extension/library/target/tool dependencies; PHP configure args; build hooks; package metadata; or related tests and docs.

StaticPHP Package Maintenance

Overview

Use this skill to make focused package changes without re-reading the entire repository. StaticPHP v3 separates declarative package/artifact YAML from package-specific PHP build logic; prefer config-only edits unless current patterns require a class.

Quick Workflow

  1. Identify the package kind and exact name.

    • Extension: config/pkg/ext/ext-name.yml, class src/Package/Extension/name.php.
    • Library: config/pkg/lib/name.yml, class src/Package/Library/name.php.
    • Target or virtual target: config/pkg/target/name.yml, class src/Package/Target/name.php.
    • Tool: config/pkg/tool/name.yml, class src/Package/Tool/name.php.
    • Shared/custom artifact: config/artifact/name.yml, class src/Package/Artifact/name.php.
  2. Search for the closest existing package before designing anything new.

    • Similar build system: rg "#\\[BuildFor|UnixCMakeExecutor|UnixAutoconfExecutor|WindowsCMakeExecutor" src/Package.
    • Similar config fields: rg "static-libs|pkg-configs|arg-type|depends@" config/pkg.
    • Similar download type: rg "type: ghrel|type: pecl|type: pie|type: git|binary: hosted" config.
  3. Read references/package-reference.md when changing YAML fields, artifact definitions, package naming, dependencies, platform suffixes, or validation expectations.

  4. Read references/build-class-patterns.md when PHP build logic, attributes, lifecycle hooks, custom configure args, source patching, or executor usage is needed.

  5. Validate narrowly, then broadly if risk warrants it.

    • Config lint: php bin/spc dev:lint-config
    • Focused tests: vendor/bin/phpunit tests/StaticPHP/Config tests/StaticPHP/Registry tests/StaticPHP/Util/DependencyResolverTest.php --no-coverage
    • Full project checks: composer test, composer analyse

Editing Rules

  • Treat config/pkg/* and config/artifact/* as the source of package truth; package classes augment behavior.
  • Use platform suffix fields for declarative OS differences: @unix, @linux, @macos, @windows.
  • Add a PHP class only for custom build stages, validation, hook behavior, patches, or custom configure arguments.
  • Keep extension dependencies prefixed with ext-; libraries, tools, and targets use their package names.
  • Prefer existing helpers such as UnixAutoconfExecutor, UnixCMakeExecutor, WindowsCMakeExecutor, shell(), cmd(), and FileSystem.
  • Do not modify build outputs (buildroot/, source/, downloads/, pkgroot/) to fix package definitions.
  • If upstream metadata changes, update license metadata and smoke-test/display names when relevant.
Show full SKILL.md (123 more words)Show less

Common Task Paths

  • Add a new PECL extension: define config/pkg/ext/ext-name.yml with type: php-extension, artifact.source.type: pecl, dependencies, and php-extension.arg-type; add a class only if configure args, patches, or hooks are non-standard.
  • Add a library: define config/pkg/lib/name.yml with artifact, dependencies, and install verification fields (headers, static-libs, pkg-configs, static-bins); add build class methods by OS.
  • Fix an existing package build: start from the failing package config/class, then inspect dependencies and hooks targeting that package before changing shared core code.
  • Update a version source: prefer artifact fields that support update checking (ghrel, ghtar, ghtagtar, git with regex, filelist, pecl, pie) over hard-coded URLs when upstream supports it.

Resources

  • references/package-reference.md: YAML package/artifact model, naming, fields, validation, and commands.
  • references/build-class-patterns.md: PHP package attributes, stages, hooks, executors, and class patterns.

© 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 3 other files (references) in .agents/skills/staticphp-package-maintenance of crazywhalecc/static-php-cli.

  • SKILL.md
  • agents/openai.yaml
  • references/build-class-patterns.md
  • references/package-reference.md

Open the folder on GitHubat commit 1a765d9

Compare with similar skills

Staticphp Package Maintenance 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 Package Maintenance compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Staticphp Package Maintenance this skillcrazywhalecc/static-php-cli1.9k—~1kAutomated safety check: PassMIT
Configuring Horizoncoollabsio/coolify63k4 repos~898Automated safety check: PassMIT
Tailwindcss Developmentanonaddy/anonaddy4.9k10 repos~865Automated safety check: PassMIT
Fortify Developmentcoollabsio/coolify63k4 repos~1.9kAutomated safety check: PassMIT
MCP Developmentcoollabsio/coolify63k1 repos~949Automated safety check: PassMIT
WooCommerce Code Reviewwoocommerce/woocommerce11k3 repos~1.1kAutomated safety check: PassCustom licence

Similar skills

  • Configuring Horizon

    coollabsio/coolify

    A skill your agent uses whenever the user mentions Horizon by name in a Laravel context.

    63k GitHub starsUsed in 4 repos~898 tokens
    Backend & APIsAuto-check passed
  • Tailwindcss Development

    anonaddy/anonaddy

    Always invoke when the user's message includes 'tailwind' in any form.

    4.9k GitHub starsUsed in 10 repos~865 tokens
    Frontend & DesignAuto-check passed
  • Fortify Development

    coollabsio/coolify

    ACTIVATE when the user works on authentication in Laravel. An agent skill from coollabsio/coolify.

    63k GitHub starsUsed in 4 repos~1.9k tokens
    Backend & APIsAuto-check passed
  • MCP Development

    coollabsio/coolify

    A skill your agent uses for Laravel MCP development. An agent skill from coollabsio/coolify.

    63k GitHub starsUsed in 1 repo~949 tokens
    Frontend & DesignAuto-check passed
  • WooCommerce Code Review

    woocommerce/woocommerce

    Reviews WooCommerce code changes against the project's standards, flagging backend PHP architecture, naming, documentation, data integrity and testing violations.

    11k GitHub starsUsed in 3 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Sync Translations

    symfony/symfony

    Synchronize translation catalogs across maintained Symfony branches: find messages that newer branches added to the English catalogs but that are still missing from the oldest maintained branch…

    31k GitHub stars~1.9k tokensUpdated today
    Writing & ContentAuto-check passed

More from crazywhalecc/static-php-cli

  • Staticphp Build Troubleshooting

    crazywhalecc/static-php-cli

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

    1.9k GitHub stars~814 tokensUpdated yesterday
    Auto-check passed
  • 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

Works with

Questions about Staticphp Package Maintenance

What does Staticphp Package Maintenance do?

Maintain StaticPHP v3 packages and artifacts. An agent skill from crazywhalecc/static-php-cli. Staticphp Package Maintenance is an agent skill from crazywhalecc/static-php-cli. Maintain StaticPHP v3 packages and artifacts.

When should I use Staticphp Package Maintenance?

Staticphp Package Maintenance fits situations like: validating config under config/pkg; config/artifact; package classes under src/Package; extension/library/target/tool dependencies.

How do I install Staticphp Package Maintenance in Claude Code?

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

How do I install Staticphp Package Maintenance in Codex?

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

Can I use Staticphp Package Maintenance 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-package-maintenance -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-package-maintenance, .gemini/skills/staticphp-package-maintenance, .github/skills/staticphp-package-maintenance and .opencode/skills/staticphp-package-maintenance in your project.

What does Staticphp Package Maintenance need to run?

Going by SKILL.md and its folder, Staticphp Package Maintenance needs the command-line tools its instructions call (rg, composer and php).

Does Staticphp Package Maintenance 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 Package Maintenance 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 Package Maintenance use?

Staticphp Package Maintenance 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 Package Maintenance use?

About 1k tokens (SKILL.md is roughly 4.1k 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 2.9k tokens, read only when the agent opens those files.

What are the alternatives to Staticphp Package Maintenance?

Skills that share tags, products or a category with Staticphp Package Maintenance: Configuring Horizon (coollabsio/coolify, 63k stars), Tailwindcss Development (anonaddy/anonaddy, 4.9k stars), Fortify Development (coollabsio/coolify, 63k stars) and MCP Development (coollabsio/coolify, 63k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Staticphp Package Maintenance?

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.