PHPackages                             your-handle/bga-dev-skill - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Testing & Quality](/categories/testing)
4. /
5. your-handle/bga-dev-skill

ActiveLibrary[Testing & Quality](/categories/testing)

your-handle/bga-dev-skill
=========================

CC skill and testing harness for BoardGameArena game development

v1.0.0(1mo ago)01PHPCI passing

Since Jul 5Pushed 4w agoCompare

[ Source](https://github.com/thebgllc/bga-assist)[ Packagist](https://packagist.org/packages/your-handle/bga-dev-skill)[ RSS](/packages/your-handle-bga-dev-skill/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (1)Versions (2)Used By (0)

bga-assist
==========

[](#bga-assist)

What This Is
------------

[](#what-this-is)

This repository gives you two things for BGA development with Claude Code: a ready-to-use skill file and a local testing harness. The skill file (`SKILL.md`) teaches Claude Code the project conventions and generation patterns, while the harness provides PHP and JS test scaffolding so generated logic can be validated locally. Use the skill alone if you only want better code generation, or use the full harness if you also want runnable tests.

Installation
------------

[](#installation)

### Skill Only (No Testing Infrastructure)

[](#skill-only-no-testing-infrastructure)

1. Clone or download this repository.
2. Add `SKILL.md` to your Claude Code workspace instructions.

### Full Harness

[](#full-harness)

1. Clone this repo into your BGA game's development dependencies.
2. Install PHP support:

```
composer require --dev thebgllc/bga-assist
```

3. Install JS support:

```
npm install --save-dev bga-assist
```

4. Extend `BgaGameTestCase` in your PHPUnit tests.

Using with Claude Code
----------------------

[](#using-with-claude-code)

These prompts are designed to map directly to the tested patterns in `SampleGameTest.php`:

1. "What happens if the active player submits only 2 cards?"
2. "Write tests for the \_checkValidSet function"
3. "Generate a states.inc.php for a game with a bidding phase and a resolution phase"
4. "I'm getting a PHP error in my action method - what's wrong?"
5. "How do I notify only the active player when they draw a card?"

Running Tests
-------------

[](#running-tests)

```
# PHP
./vendor/bin/phpunit

# JS
npm test
```

Scope Boundaries
----------------

[](#scope-boundaries)

This v1 repo intentionally does not include:

- MCP server setup
- SFTP deployment tooling
- Studio log tailing
- Playwright live Studio E2E tests
- BGA Studio API integration
- Game-specific production implementations

###  Health Score

34

—

LowBetter than 74% of packages

Maintenance93

Actively maintained with recent releases

Popularity1

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity33

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

48d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/34245984?v=4)[Jim Barr](/maintainers/jcbarr)[@jcbarr](https://github.com/jcbarr)

---

Top Contributors

[![thebgllc](https://avatars.githubusercontent.com/u/33202861?v=4)](https://github.com/thebgllc "thebgllc (18 commits)")

---

Tags

bga-studioboardgamearenaboardgamesclaudephpunittesting

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/your-handle-bga-dev-skill/health.svg)

```
[![Health](https://phpackages.com/badges/your-handle-bga-dev-skill/health.svg)](https://phpackages.com/packages/your-handle-bga-dev-skill)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)