Agents

NativeForm Skills

Get started by installing the published skill:

npx skills add https://github.com/Theoreumont/nativeform-skills --skill nativeform-agent-workbench

The package at skills/nativeform-agent-workbench encodes the canonical guidance and workflows that tell your AI agent: yes, you can drive NativeForm. The skill bridges documentation, manifest discovery, CLI snippets, and fallback behaviors so agents behave consistently.

Think of the skill as the quickest way to make an agent NativeForm-aware. It complements MCP tools, the CLI, direct API usage, and public fill rather than replacing any of them.

Capabilities surfaced by the skill

The skill keeps your agent grounded in NativeForm expectations.

  • •Expose the public form manifest so agents know every field, validation hint, and rate limit.
  • •Link to the correct headers: `x-nativeform-agent`, optional version/channel metadata, and the agent-friendly HTTP fallback pages.
  • •Walk agents through creating drafts, submitting final responses, and offering the ChatGPT fallback confirmation link when APIs are blocked.
  • •Surface typed errors (422/429/POLICY_DISABLED) plus guidance on `fieldErrors` so retries are specific.

Installation & discovery

Install the published skill so agents can resolve it by name. The same documentation lives at skills/nativeform-agent-workbench for offline inspection.

Install command

npx skills add https://github.com/Theoreumont/nativeform-skills --skill nativeform-agent-workbench

Once installed, agents scan `$$CODEX_HOME/skills/nativeform-agent-workbench` for `SKILL.md` and linked references. Until `skills.sh` automation exists, manually syncing the repo folder into your skills directory keeps everything up to date.

Governance

Treat the skill like a public API contract.

Mirror the agent-skill handoff plan

`docs/agent-skill-handoff-2026-02-14.md` lays out the automation, installer, and testing checklist; keep this page aligned with that intent.

Keep install paths honest

The skill lives in `skills/nativeform-agent-workbench`. Until `skills.sh` exists, rely on `npx skills add ...` or manual copy/paste into `$CODEX_HOME/skills`.

Version & test before publish

Any behavior change that affects the skill’s hints should be noted in release/version sections so consuming agents can pin or roll back safely.

Keep this doc, docs/agent-skill-handoff-2026-02-14.md, and any tests in sync so that pushing updates to NativeForm components does not break the skill experience.