Use the FilePond agent skill

The editable source is skills/yii2-filepond-uploads/SKILL.md in this package. It helps an agent combine the upload widget, option precedence, image editing, and validated server storage. The documentation site consumes the package guides and skill; its published files are generated outputs.

Install in an application

Run the pinned installer from the application’s root, selecting the clients you use:

npx skills@1.7.2 add /absolute/path/to/filepond --list
npx skills@1.7.2 add /absolute/path/to/filepond \
  --skill yii2-filepond-uploads --agent claude-code codex opencode

The source can be a package checkout or ./vendor/yii2-extensions/filepond when that installed release includes the skill. For published GitHub releases, list before installing:

npx skills@1.7.2 add yii2-extensions/filepond --list
npx skills@1.7.2 add yii2-extensions/filepond \
  --skill yii2-filepond-uploads --agent claude-code codex opencode

Use the GitHub command only after listing confirms the skill: unpublished local changes are not on the default branch. Keep project scope. The installer uses links by default; --copy creates an installation snapshot that must be refreshed when upgrading. Installed copies are outputs, not another editable source.

Installing the Composer package alone does not expose skills in vendor/ to an agent opened at the application root. Install the skill explicitly. Guides excluded from Composer archives remain available as published Markdown.

Paths and activation

Client	Project path	Explicit activation
Claude Code	.claude/skills/yii2-filepond-uploads/SKILL.md	/yii2-filepond-uploads
Codex	.agents/skills/yii2-filepond-uploads/SKILL.md	$yii2-filepond-uploads or the skill picker
OpenCode	.opencode/skills/yii2-filepond-uploads/SKILL.md, or .agents/skills/	Ask it to load yii2-filepond-uploads through its skill tool

The verified skills 1.7.2 installer uses .agents/skills/ for Codex and OpenCode, and .claude/skills/ for Claude. For manual installation, copy or link the complete skill directory, retaining <name>/SKILL.md. Avoid separately edited copies or multiple installations of the same name within a client’s search paths.

This source checkout exposes links in .agents/skills/ and .claude/skills/ to the canonical skills/ directory. No per-client version of the instructions is maintained. When using OpenCode, verify how the installed version handles the two aliases; the installer needs only its .agents/skills/ installation.

Verify each stage

1. Installation: the directory and frontmatter exist in the chosen client path.
2. Discovery: open a fresh client session at the application root and check its skill list or picker.
3. Activation: invoke the skill and verify the client loaded its body. Automatic selection is model-dependent; reading SKILL.md manually is separate evidence.
4. Selective consultation: use the relevant local guide, or the skill’s direct published Markdown links, rather than loading the entire documentation index.
5. Functional result: test the generated form, effective plugins, invalid-input rejection, and validated storage.

--list verifies the installer’s discovery only; it does not run Claude, Codex, or OpenCode. Application instructions and permissions still apply when a skill is activated.