1
What each field means
  • id unique integer — use the next number after the last puzzle
  • clue full clue text including letter count at the end, e.g. (5)
  • answer solution in UPPERCASE; space between words e.g. TWO WORDS
  • definition the part of the clue that directly defines the answer
  • fodder the letters or words being manipulated
  • indicator word(s) signalling what wordplay is happening
  • type anagram, hidden, charade, homophone, or double def
  • difficulty easy, medium, or hard
  • date today's date in YYYY-MM-DD format
  • explanation step-by-step walkthrough of how the clue works
  • author your name — shown on the puzzle page as Clue by You ✒️
2
Copy the template

Fill in every field, then paste it as the entire contents of your new yourname.json file.

{ "id": 151, "clue": "Your cryptic clue text here (5)", "answer": "ANSWER", "definition": "the defining part of the clue", "fodder": "letters or words being manipulated", "indicator": "wordplay indicator word(s)", "type": "anagram", "difficulty": "medium", "date": "2026-05-19", "explanation": "Step-by-step breakdown of how the clue works.", "author": "Your Name" }
⚠️ Validate your JSON before submitting — no trailing commas, all strings in double quotes. Check at jsonlint.com.
3
Submit on GitHub
Create your file

Click the button below — it opens GitHub's new-file editor inside puzzles/ and forks the repo automatically. Name the file after yourself — e.g. meenz.json — and paste your JSON.

Raise a Pull Request

Scroll down, set the commit message to Add clue #151 by Your Name, then click Propose new file → Create Pull Request.

4
Rules for a good clue
🎯
One clear definition
Must appear at the start or end — never buried in the middle.
🔤
Letter count
Always include answer length in brackets — (5) or (3,4).
⚖️
Fair wordplay
Every letter must be accounted for — no extras, no missing letters.
🚫
No spoilers
The answer must not appear in the clue in any form.
Precise indicator
mixed, cooked for anagram; sounds like, reportedly for homophone.
📖
Explain clearly
Walk through the solve step by step — assume the reader is new to cryptics.
GOT A CLUE WORTHY OF A GENIUS?
Create your yourname.json inside puzzles/ — GitHub forks the repo automatically.
✏️  CREATE MY CLUE FILE