# Authoring Godot Prompter Skills

Use when writing or editing a SKILL.md, a skill's references/*.md, or an agent...

- Repository: https://github.com/jame581/GodotPrompter (914 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add jame581/GodotPrompter --skill authoring-godot-prompter-skills -g -a claude-code -y`
Codex: `npx skills add jame581/GodotPrompter --skill authoring-godot-prompter-skills -g -a codex -y`
Cursor: `npx skills add jame581/GodotPrompter --skill authoring-godot-prompter-skills -g -a cursor -y`
Gemini CLI: `npx skills add jame581/GodotPrompter --skill authoring-godot-prompter-skills -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add jame581/GodotPrompter`

## Description

Use when writing or editing a SKILL.md, a skill's references/*.md, or an agent definition in this repo, required frontmatter, section ordering, the GDScript-then-C# example convention, and C# parity exemptions.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Authoring GodotPrompter skills and agents

File format templates for this repo. See the root `CLAUDE.md` for the conventions
and size budget that govern the content itself.

## SKILL.md format

Every skill must start with YAML frontmatter:

```yaml
---
name: skill-name
description: Use when [trigger], [brief scope]
---
```

Followed by:
1. Title and intro
2. Related skills line: `> **Related skills:** **skill-a** for X, **skill-b** for Y.`
3. Numbered sections with patterns and examples
4. GDScript first, then C# equivalent (use `gdscript` and `csharp` language tags)
5. Implementation checklist at the end

## C# parity

The validator also checks C# parity inside `references/*.md` (`csharp-parity-*-reference`), so Pattern X moves stay enforced. Files that section **by language** (`## C#`, `## Dash (C#)`, `### …, C#`) are checked file-level instead of per-section; a heading that merely mentions C# in prose is not a partition.

When a section genuinely cannot have a C# counterpart, mark that section, never the whole skill:

```markdown
<!-- csharp-parity: n/a, C# is statically typed; there is no untyped alternative to contrast -->
```

It works in both `SKILL.md` and `references/*.md`. The reason is **mandatory**; omitting it is an error (checked on every marker, not only on sections missing C#), because an exemption that cannot say why is indistinguishable from an example nobody wrote. A reason may contain `<` and `>`, and a marker inside a fenced block is ignored, so a file can document the marker without exempting itself.

Do **not** reach for the two blunter tools instead: adding the skill to `GDSCRIPT_ONLY_BY_DESIGN` exempts every section in it, and renaming a heading to `"… (GDScript)"` trips the language-partition check and silently downgrades the *entire file* to a file-level check. Both hide real gaps in neighbouring sections.

The rest: https://github.com/jame581/GodotPrompter/blob/HEAD/.claude/skills/authoring-godot-prompter-skills/SKILL.md