Skip to content

AgentFEM skill

The repository ships a standards-compatible AgentFEM skill that teaches coding agents the public workflow, project lifecycle, result contract, scientific validation boundary, and safe extension rules.

The canonical source is skills/agentfem/SKILL.md. It is versioned with the code so that agent behavior can evolve alongside API and project-format changes.

The directory is self-contained: keep SKILL.md, agents/, and references/ together. A skill-aware agent can load it directly from the repository. For a personal Codex installation, copy or link the complete skills/agentfem/ directory to $CODEX_HOME/skills/agentfem/ (or ~/.codex/skills/agentfem/ when CODEX_HOME is unset); copying only SKILL.md omits the scientific and implementation references.

The main skill stays concise and routes detailed material progressively: workflow guidance is read for modeling tasks, while concepts, module ownership, validation, and extension rules are loaded only when the task requires them.

What the skill is for

  • discover and validate an AgentFEM installation;
  • create and operate projects through the public workflow;
  • interpret structured failures and simulation results;
  • preserve the distinction between execution and scientific verification;
  • route reusable finite-element functionality to the correct module;
  • upgrade older projects without silently rewriting scientific intent.
  • freeze runtime and scientific-input evidence, run safe local ensembles, and build traceable convergence/loading/response experiments;
  • inspect declared private extensions without automatically executing or installing untrusted packages.

The skill does not guess API keywords. It begins with agentfem.public_api("core"), models.model_api("core"), and the provider contracts reported by agentfem capabilities --json. Compatibility names may remain executable during 0.2.x, but new cases use the canonical vocabulary.

The skill complements the machine-readable /agentfem.json manifest and scientific src/agentfem/knowledge/catalog.json; it does not replace the public API or the solver's deterministic checks.