SkillAgentSearch skills...

pair

Lightweight PHP framework for maintainable business applications, with explicit architecture and a companion Codex plugin.

Install / Use

npx skills add viames/pair

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

72/100

Supported Platforms

Universal

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.

Substance
26/30
Structure
16/20
Description
15/15
Adoption
0/20
Freshness
15/15

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 found

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.

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.

SkillScoreStarsUpdatedFormat
pair (this skill)by viames7203d agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
ai-job-searchby ai-job-search-dev10072.1ktodayCLAUDE.md
claude-howtoby luongnv8910047.3k2d agoCLAUDE.md
lobehubby lobehub10085.6ktodayMCP 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.

name: "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

View on GitHub
GitHub Stars0
CategoryDevelopment
Updated3d ago
Forks0

Trust signals

80/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 medium1 low