servicetitan-forms-skill

A Claude skill for building, fixing, and refactoring ServiceTitan Form 2.0 JSON configurations.

Covers:

• The IsForm20 flag and Form 2.0 envelope structure
• Conditional logic / show–hide rules and micro-rule splitting
• Common 400 ValidationException causes on form import
• fieldType pitfalls (e.g. Photo vs Picture)
• The "Something went wrong" preview error
• Stoplight and checkbox-driven visibility patterns
• Turning plain-English form descriptions into valid Form 2.0 JSON

All patterns verified against live tenant exports.

Install — Claude Code

/plugin marketplace add lpeluso-dotcom/servicetitan-forms-skill
/plugin install servicetitan-forms@servicetitan-forms-skill

Update later with:

/plugin marketplace update servicetitan-forms-skill

Install — Claude.ai (web / desktop)

1. Download or clone this repo.
2. Zip the plugins/servicetitan-forms/skills/servicetitan-forms/ folder.
3. In Claude.ai go to Customize → Skills → Upload and select the zip.

(Requires code execution to be enabled in your settings. On Team / Enterprise plans, an org owner can provision it organization-wide via Organization settings → Skills.)

Install — Claude API

Upload via the Skills API, then reference the returned skill_id in your container parameter.

Repo layout

servicetitan-forms-skill/
├── .claude-plugin/
│   └── marketplace.json
└── plugins/
    └── servicetitan-forms/
        ├── .claude-plugin/
        │   └── plugin.json
        └── skills/
            └── servicetitan-forms/
                └── SKILL.md      ← the actual skill

Trust note

Skills can include scripts and instructions that run in Claude's code-execution environment. Before installing any skill from a third party, review the contents of SKILL.md and any bundled files. This skill ships only Markdown — no scripts, no network calls, no bundled binaries.

License

MIT — see LICENSE.

Contributing

Issues and PRs welcome. If you hit a Form 2.0 edge case this skill doesn't cover, open an issue with a redacted JSON snippet and the error you're seeing.