Agent skill

The fp2 skill teaches coding agents the deployed onboarding, repair, context, issue-transition, claim, and handoff workflow. It explicitly refuses to invent coordination features that are not shipped.

In the fp2 repository

The canonical skill is checked in at:

.agents/skills/fp2/SKILL.md

Codex discovers it from within the repository. Invoke $fp2 when an agent needs to:

  • install or authenticate the CLI;
  • diagnose repository readiness;
  • bind a repository to a selected project;
  • recover issue context;
  • create, list, or inspect issues;
  • move issues through legal retry-safe status transitions;
  • claim an issue so no other agent works it, and release it afterwards;
  • name the pull request that carries an issue out;
  • read which humans are in the organization, so a question names somebody who might answer it;
  • leave retry-safe progress or handoff comments.

From the documentation site

Fern publishes the generated skill bundle at:

https://docs.new.fp.dev/.well-known/agent-skills/index.json
https://docs.new.fp.dev/.well-known/agent-skills/fp2/SKILL.md

The published copy is generated from the checked-in canonical skill. Its discovery manifest includes a SHA-256 digest.

Guardrails

  • Each agent uses its own attributable identity.
  • Mutating commands require caller-stable client_id values.
  • A timeout does not justify creating a new retry ID.
  • Open issues and suggested operations are not readiness or ownership signals; holder is the only ownership signal.
  • Credentials and OTPs must never appear in logs, repositories, or handoffs.