agentic-fm skill
A Claris FileMaker harness: 25 agent skills analyze a solution, write scripts as fmxmlsnippet and design schemas and layouts
- 98 ★ on the repository
- Last commit
Broad access
Why this level
- The companion HTTP server on port 8765 executes shell commands on requests from FileMaker
- Reads the full export of a FileMaker solution with schema and logic and writes files into the repository folder
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/agentic-fmDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The companion HTTP server on port 8765 executes shell commands on requests from FileMaker
- Reads the full export of a FileMaker solution with schema and logic and writes files into the repository folder
This is third-party code. Review the repository files before installing.
What it does
agentic-fm gives an agent structured knowledge of a FileMaker solution: schema, scripts, layouts and relationships. Data is exported with Save a Copy as XML and parsed by the fm-xml-export-exploder utility into `agent/xml_parsed/`. Before a session the Push Context script writes the current layout and task into `agent/CONTEXT.json`. The agent reads the context and generates `fmxmlsnippet` in `agent/sandbox/`, `validate_snippet.py` checks the result and `clipboard.py` puts it on the clipboard for pasting into the FileMaker script editor. The `.cursor/skills` and `.claude/skills` folders hold 25 skills: `setup`, `solution-analysis`, `schema-plan` and `schema-build`, `script-review`, `script-test`, `script-debug`, `script-refactor`, `layout-design`, `layout-spec`, `fmlint`, `data-migrate`, `data-seed`, `extract-erd`, `webviewer-build` and more. There are two modes: a visual script editor in the browser or in a FileMaker Web Viewer (Monaco with AI chat) and work from Claude Code, Cursor or VS Code. You need FileMaker Pro 21 or newer, Python 3 and fm-xml-export-exploder. The easiest start is to clone the repository and tell the agent "Help me set up agentic-fm": the `/setup` skill checks dependencies.
Who it is for. Claris FileMaker developers who want to write and review scripts, schema and layouts together with Claude Code or Cursor.
Good fit when
- You must make sense of someone else's FileMaker solution: schema and scripts as an ERD and report
- A script must be written from a description, checked with `validate_snippet.py` and pasted through the clipboard
- A tangled script needs debugging or refactoring while keeping its behavior
- A layout and tables for a new module must be designed and filled with test data
Not a fit when
- FileMaker older than 21: the scripts need GetTableDDL, While and data file steps
- You need to change a live database directly: output is pasted into FileMaker by hand through the clipboard
- The solution is not on FileMaker: the set is entirely about Claris FileMaker
Example request
Help me set up agentic-fm. Then analyze the solution export and describe which tables relate to the Orders tableLimitations
- FileMaker Pro 21 or newer, Python 3 (standard library only), xmllint and the fm-xml-export-exploder binary, downloaded separately and placed in `~/bin`, are required.
- Pasting the result is manual: the agent puts `fmxmlsnippet` on the clipboard and the user pastes it into the script editor.
- Running scripts from FileMaker needs a companion HTTP server `companion_server.py` on port 8765 that executes shell commands. Start it before work and keep it on your own machine only.
- Context goes stale: the tool warns when `CONTEXT.json` is older than 60 minutes. The web editor needs Node.js 18 or newer.
How to disable. Stop `companion_server.py` and delete the agentic-fm scripts and the `Context` custom function from your FileMaker solution. The repository folder and skills can be deleted from disk.
FAQ
Where do I start with agentic-fm?
Clone the repository, open it in Claude Code or Cursor and type "Help me set up agentic-fm". The `setup` skill checks dependencies and walks through the steps, and the reference lives in `QUICKSTART.md`.
What is fmxmlsnippet?
It is the FileMaker clipboard format for individual objects: script steps, fields, layouts. The agent delivers code in this format and it is pasted into the script editor with Cmd+V.
Which versions and tools are required?
FileMaker Pro 21.0 or newer (`GetTableDDL`, `While` and data file steps are required), Python 3, xmllint and fm-xml-export-exploder. Node.js 18 is needed only for the web editor.
Why is the companion server needed?
FileMaker calls it through `Insert from URL` to run shell commands: export, XML parsing, clipboard writes. It listens on port 8765 and runs while the terminal stays open.
Can I work without Claude Code?
Yes. A visual script editor with AI chat runs in the browser or inside a FileMaker Web Viewer. Skills are also provided for Cursor, and any terminal agent works in VS Code.
Discussion
No questions or reviews yet.
Related
SkillsThe author's personal set: shared agent rules and dozens of skills for GitHub, the browser, macOS, messaging and releases, plus a sync script
agent-toolkit offers generic skills for engineering tasks: from a ticket to a plan, tasks and a handover for review.
Softaworks Agent Toolkit
Softaworks Agent Skills
A marketplace of skills, subagents and commands for coding agents: development, documentation, planning and workplace communication
Builder Skills
Skills for agents
A set of small skills from Builder.io for agent work habits: visual plans and diff recaps, docs-first checks, cross-agent review and clean status updates
skills-npm links agent skills shipped in your dependencies in node_modules and listed in the skills field of package.json
my-skills by akitaonrails
akitaonrails my-skills
Fabio Akita's personal set of 24 skills for Claude Code, Codex and opencode: releases, PR audits, security and fact-checking
README in short
The README explains how FileMaker connects to external tools through three XML formats (DDR, Save a Copy as XML, fmxmlsnippet) and why the project uses the last two. Dependencies, six install steps, a six-step workflow and a catalog of skills framed as opt-in workflows follow.