# AI assistance

> The editable source is skills/yii2-dynamicform/SKILL.md in this package.

The editable source is [`skills/yii2-dynamicform/SKILL.md`](https://github.com/yii2-extensions/dynamicform/blob/main/skills/yii2-dynamicform/SKILL.md) in this package. It
helps an agent render, nest and validate repeatable ActiveForm rows and rebuild the posted rows with
`Model::createMultiple()`.

## Install in an application

### Automatic Composer installation

Complete the
[one-time application setup](https://yii2-framework.github.io/docs/project/ai-agents/#composer-installation) to enable
`llm/skills` and set `auto-sync` to `true` in `skills.json`. Approve `yii2-extensions/dynamicform` explicitly in
`dependencies.composer.trusted`. The installed package must include its skill bundle; its `extra.skills.source` declares
the directory.

```bash
composer install
composer skills:show
```

With `auto-sync` enabled, later dependency installs and updates synchronize the skill automatically; no per-skill
installer is required. If `auto-sync` is `false`, run `composer skills:update` after dependency installation or updates.

### Optional npx installation

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

```bash
npx skills@1.7.2 add /absolute/path/to/dynamicform --list
npx skills@1.7.2 add /absolute/path/to/dynamicform \
  --skill yii2-dynamicform --agent claude-code codex opencode
```

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

```bash
npx skills@1.7.2 add yii2-extensions/dynamicform --list
npx skills@1.7.2 add yii2-extensions/dynamicform \
  --skill yii2-dynamicform --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 in the repository at the matching
reference.

## Paths and activation

| Client                                                | Project path                                                       | Explicit activation                                      |
| ----------------------------------------------------- | ------------------------------------------------------------------ | -------------------------------------------------------- |
| [Claude Code](https://code.claude.com/docs/en/skills) | `.claude/skills/yii2-dynamicform/SKILL.md`                         | `/yii2-dynamicform`                                      |
| [Codex](https://learn.chatgpt.com/docs/build-skills)  | `.agents/skills/yii2-dynamicform/SKILL.md`                         | `$yii2-dynamicform` or the skill picker                  |
| [OpenCode](https://opencode.ai/docs/skills/)          | `.opencode/skills/yii2-dynamicform/SKILL.md`, or `.agents/skills/` | Ask it to load `yii2-dynamicform` 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 repository guide at the matching reference, rather
   than loading the entire documentation index.
5. **Functional result:** test inserted, deleted and renumbered rows, their client validation, nested widgets and the
   posted payload.

`--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.

## Example prompts

Start a fresh client session at the application root. The explicit example uses Codex's `$skill-name` notation; use
`/yii2-dynamicform` in Claude Code or the installed client's native skill mechanism. Do not paste the skill body and
count that as native activation. These are tasks to execute and verify, not claims that an evaluation has passed.

### Explicit invocation

```text
$yii2-dynamicform
Show a repeatable ActiveForm with add/remove rows and server-side Model::createMultiple() handling for the installed
DynamicForm version. Include checks for row names, validation errors and empty submissions before persistence.
Inspect the installed revision first. Do not install dependencies or change files without authorization.
```

### Natural selection

```text
After removing and adding a dynamic form row, the posted names and validation errors no longer match. How can I
reproduce and diagnose the row identity problem without disabling validation?
```

### Verify the outcome

Exercise insert, delete and renumber behavior in the browser and inspect the posted payload plus server validation; a
screenshot is not an executed form. Record native loading evidence separately from configuration review, executable
checks and browser/runtime results. For a negative selection control, ask an unrelated question in a fresh session and
confirm this package skill is not loaded. Keep evaluation traces private; report unavailable checks rather than treating
discovery as execution.

[Back to documentation](/docs/extensions/dynamicform/index.md#documentation)