pair
Lightweight PHP framework for maintainable business applications, with explicit architecture and a companion Codex plugin.
Install / Use
npx skills add viames/pairInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Tags
Our assessment of pair
pair scores 72/100 on our quality scale, 3840th of 4,698 Development & Engineering skills we index.
Its SKILL.md is 5.6 KB long, split into 5 sections with 3 code examples: a solid amount of guidance for an agent.
It has no GitHub stars yet, so there is no community track record; judge it on its content.
Maintenance, license and trust
- The repository was last updated 3 days ago, so pair is actively maintained.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 80/100, with 2 cautions from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-16. Automated pattern scan on 2026-11-16. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
pair compared with similar skills
All 4 of these similar skills score higher than pair; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| pair (this skill)by viames | 72 | 0 | 3d ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
| lobehubby lobehub | 100 | 85.6k | today | MCP Server |
Frequently asked questions
- How do I install pair?
- Run
npx skills add viames/pair. The install tabs above show the steps for each supported agent. - Which AI agents does pair work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is pair safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 80/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is pair still maintained?
- The repository was last updated 3 days ago, so pair is actively maintained.
Skill content
View source on GitHubname: "Pair Framework" slug: "pair" version: "4.1.0" description: "Entry skill for assistants working on the Pair v4 framework repository." tags:
- php
- pair
- framework
- review language: "en"
Pair Framework v4 — Quick start
Read AGENTS.md first. It owns version scope, workflow, conventions, change hygiene, document ownership, conflict resolution, and completion format. This file provides navigation and commands for framework development.
Choose the next document
| Need | Read | | --- | --- | | Framework internals and request flow | Architecture | | Concrete implementation examples | Patterns | | Avoiding assumptions from other frameworks | Context | | Work crossing layers, migration, or performance risk | Task guidance | | Migrating a consuming application to v4 | Upgrade guide | | Application setup and public API reference | Pair wiki | | Releases and package contents | Release workflow, Composer dist contents |
For a small local task, stop after this file unless a specific uncertainty requires another document.
Component map
Paths are relative to the framework repository, not a consuming application's
vendor/viames/pair directory.
| Area | Responsibility and starting points |
| --- | --- |
| src/Core | Bootstrap, routing, environment, logging, runtime adapters; Application.php, Router.php. Legacy Controller.php, Model.php, View.php support migration. |
| src/Web | Explicit web controllers, page and fragment responses; Controller.php, PageResponse.php, FragmentResponse.php. |
| src/Http | Immutable input, uploads, response contracts, JSON/text responses and HTTP caching; Input.php, ResponseInterface.php. |
| src/Data | Explicit read contracts and mapping; ReadModel.php, RecordMapper.php, Payload.php. |
| src/Api | API controllers, request validation, CRUD, middleware, throttling, OpenAPI; ApiController.php, Request.php, RequestData.php. |
| src/Orm | Persistence, queries, collections and database access; ActiveRecord.php, Query.php, Collection.php, Database.php. |
| src/Models | Built-in framework records, including users, sessions, ACL and API tokens. |
| src/Html | Forms, controls, menus, UI rendering and templates; Form.php, FormControl.php. |
| src/Helpers, src/Traits | Shared utilities and small reusable behaviors. |
| src/Cache, src/Search | Cache stores and search indexing contracts. |
| src/Services, src/Push | External integrations, notification delivery and subscriptions. |
| src/Packages | Installable ZIP/manifest packages, separate from runtime extensions. |
| src/Console | Module, API and CRUD generation; MakeCommand.php. |
| src/Exceptions | Framework exceptions and error codes. |
| assets, translations, migrations | Frontend helpers, localization and framework schema migrations. |
| mobile | Native iOS and Android client sources; excluded from Composer dist. |
| tests/Unit, tests/Support, tests/Fixtures | Behavioral tests, isolated doubles and fixture applications. |
Targeted searches
Search by class or namespace, then by method within the owning component. Read one complete nearby class and its tests before editing.
rg --files src/Web src/Http tests/Unit/Web tests/Unit/Http
rg -n 'function page|function pageOrFragment' src/Web
rg -n 'checkToken|validateToken' src/Html tests/Unit/Html
rg -n 'data-text|data-show' assets/PairUI.js
For web requests, start in src/Web and src/Http; inspect src/Core for
application dispatch or legacy modules. For APIs, start in src/Api.
Search forms and frontend behavior in src/Html and assets together.
The wiki provides focused references for controllers, ORM, forms, PairUI, and environment configuration. Compare them with the checked-out source when behavior is uncertain.
Local verification
From the framework root, after installing development dependencies:
composer install
composer test
vendor/bin/phpunit -c phpunit.xml.dist tests/Unit/Web/ControllerTest.php
For database compatibility, provision the disposable schema described in
the MySQL integration guide, then run
composer test:mysql. This separate suite targets real MySQL 8.0, 8.4 and 26.10
connections; never configure it with an application's database.
Run composer test:install to test the actual Composer dist and executable in
isolated consuming projects. Add -- ../pair_boilerplate for stable starter
creation, CLI, installer and baseline checks. See the
installation test guide for optional
disposable MySQL credentials and local artifact fixtures.
Choose the relevant test path for a focused check. Use composer run benchmark-v4
when assessing v4 migration/performance behavior; it is not required for every edit.
For documentation-only work, check links, source references and example syntax.
Run generators from a consuming application with Pair installed:
vendor/bin/pair make:module orders
vendor/bin/pair make:api api
vendor/bin/pair make:crud order --table=orders --fields=id,customer_id,total_amount
Application upgrade commands and their dry-run/write behavior belong in the upgrade guide; do not infer migration safety from generator commands.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.3kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
lobehub
85.6k🤯 LobeHub - Super-Agents on Your Team. Add super-agents to the chats your team already uses.They take on work by themselves and get better every week.
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
