About defold-skill-maintain
A maintenance skill for Defold skills that fetch documentation or examples. It provides procedures to refresh their link tables from official indexes and manage proto-file references.
Key features
- 01Refresh documentation link tables
- 02Use official API and manual indexes
- 03Keep example links synchronized
- 04Manage proto-file references
- 05Fetch stable SDK proto schemas
Use cases
- 01Updating Defold API skill links
- 02Refreshing manual and example indexes
- 03Maintaining proto references
- 04Downloading missing proto schemas
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/defold-skill-maintainin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
assets/proto/particle_ddf.protorig_ddf.protoassets/proto/ddf/ddf_extensions.protoddf_math.protoassets/proto/engine/engine_ddf.protoassets/proto/gameobject/gameobject_ddf.protolua_ddf.protoproperties_ddf.protoassets/proto/gamesys/atlas_ddf.protobuffer_ddf.protocamera_ddf.protogamesys_ddf.protogui_ddf.protolabel_ddf.protomesh_ddf.protomodel_ddf.protophysics_ddf.protosound_ddf.protosprite_ddf.prototexture_set_ddf.prototile_ddf.protoassets/proto/graphics/graphics_ddf.protoassets/proto/render/font_ddf.protomaterial_ddf.protorender_ddf.protoassets/proto/resource/liveupdate_ddf.protoresource_ddf.protoassets/proto/script/ddf_script.protolua_source_ddf.protosys_ddf.protoDetails
From the project READMEDefold Skill Maintenance
Handles maintenance tasks for other Defold skills: updating link indexes and managing proto file references.
Read guide first about the best practices for Agent Skills: references/The-Complete-Guide-to-Building-Skill-for-Claude.md.
Capability 1: Updating link lists in fetch skills
The defold-api-fetch, defold-docs-fetch, and defold-examples-fetch skills contain hardcoded link tables. These tables should be kept in sync with the official Defold index files.
Index sources
- API index:
https://defold.com/llms/apis.md— links to per-namespace API Markdown files - Manuals index:
https://defold.com/llms/manuals.md— links to per-manual Markdown files - Examples index:
https://defold.com/llms/examples.md— links to per-example Markdown files
Procedure: update link lists
- Fetch the relevant index page(s) by downloading the URL content.
- Parse the Markdown content. Each index page contains links in the form
[Title](url)grouped by sections. - Compare parsed links against the current SKILL.md of the target skill.
- Update the SKILL.md link tables to match the index, preserving the table structure and the
## Usagefooter section.
Target skill files
.agents/skills/defold-api-fetch/SKILL.md— updated fromapis.md.agents/skills/defold-docs-fetch/SKILL.md— updated frommanuals.md.agents/skills/defold-examples-fetch/SKILL.md— updated fromexamples.md
Rules
- Keep the YAML frontmatter (
---block) unchanged. - Keep the intro line
Fetch documentation from the links below (the URLs point to plain Markdown files).unchanged. - Keep the
## Usagesection at the bottom unchanged. - Replace the link tables between frontmatter and Usage section with the parsed content from the index.
- Preserve section grouping and table formatting style that already exists in each skill.
Capability 2: Managing proto file references
For detailed instructions on creating, updating, and maintaining proto file references for the defold-proto-file-editing skill, see references/proto-reference-guide.md.
Scripts
scripts/fetch_proto.py— downloads proto schemas from the stable Defold SDK into.agents/skills/defold-skill-maintain/assets/proto/. Run when proto schemas are missing or need updating:python .agents/skills/defold-skill-maintain/scripts/fetch_proto.py