Skip to content
Back to search

freehandfont

SkillWorks with Claude CodeGitHub

Turn someone's handwriting into a real installable font (.otf, Regular and optionally Bold) from phone photos of letters written on any paper. Use when the user says "/freehandfont", wants a font of their own handwriting, or wants to turn handwritten letters into a typeface.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mamamamartin--freehandfont/badge.svg)](/listings/mamamamartin--freehandfont)

HTML

<a href="/listings/mamamamartin--freehandfont"><img src="/api/listings/mamamamartin--freehandfont/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

git clone https://github.com/MamamaMartin/freehandfont ~/.claude/skills/freehandfont

Then type `/freehandfont` in Claude Code.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 148 lines
  1. ---
  2. name: freehandfont
  3. description: Turn someone's handwriting into a real installable font (.otf, Regular and optionally Bold) from phone photos of letters written on any paper. Use when the user says "/freehandfont", wants a font of their own handwriting, or wants to turn handwritten letters into a typeface.
  4. ---
  5. # Freehandfont
  6. Pen, paper, phone, font. No printer needed. All the work is done by `freehandfont.py`, which sits in this skill's base directory. Call it `FF` below.
  7. ## 0. Setup (once)
  8. ```bash
  9. python3 -m venv ~/.cache/freehandfont-venv
  10. ~/.cache/freehandfont-venv/bin/pip install -r <skill dir>/requirements.txt
  11. ```
  12. Use `~/.cache/freehandfont-venv/bin/python` for every command below. Put the work in a folder the user picks, for example `~/freehandfont-<name>`, with `work/` for glyphs and `out/` for the fonts.
  13. ## 1. Ask first
  14. Ask the user for these, in one message:
  15. - **Font name**, e.g. "Ada Hand".
  16. - **Pen colour**: blue, black, red or green. Any ballpoint or fineliner works. Pencil does not.
  17. - **Extra letters** beyond basic A to Z, digits and punctuation, e.g. `åäöÅÄÖ`, `éèàçÉ`, `ñ¿¡`, `ßüÜ`.
  18. - **Weights**: Regular only, or Regular and Bold. Bold is a second full set written with a thicker pen (a felt tip or marker).
  19. ## 2. Tell them what to write
  20. Any paper works, ruled or blank. Ask them to write, in rows:
  21. - capitals: `A B C ... Z` plus their extra capitals
  22. - small letters: `a b c ... z` plus their extra small letters
  23. - digits: `1 2 3 4 5 6 7 8 9 0`
  24. - punctuation: `. , ; : ! ? ' " - ( ) / & @ # $ % * + = _ [ ] { } < > | \ ^ ~` and any they use, like `€ £`
  25. Tips to pass on:
  26. - Leave about a finger's width between characters, and don't let them touch.
  27. - Write the way you normally do, slightly bigger is fine. Keep each row on one line.
  28. - A mistake? Scribble it out and write it again next to it.
  29. - Take close-up photos, 1 to 3 per weight, from straight above, in daylight, without your shadow on the page. Turning the phone sideways is fine.
  30. ## 3. Cut out the letters
  31. Do one photo at a time, and do photos that have letters before ones that only have punctuation.
  32. **First a preview:**
  33. ```bash
  34. FF cut IMG_1.HEIC --pen blue --out work/regular
  35. ```
  36. It prints how many rows it found and how many glyphs in each, and writes `work/regular/preview-IMG_1.png`. **Open the preview with the Read tool.** It shows the ink with a numbered box around every glyph and a label for every row.
  37. - Letters sideways or upside down? Run again with `--rotate 90`, `180` or `270` (degrees clockwise).
  38. - Two characters in one box: run again with a smaller `--gap` (default 0.25), e.g. `0.15`.
  39. - One character split into two boxes: run again with a bigger `--gap`, e.g. `0.4`.
  40. **Then say what each row is.** Write a rows file, one line per row in the preview, top to bottom, with each box's character in order:
  41. ```
  42. ABCDEFHIJK
  43. LMNOPQRSTUVW
  44. abcdefghijkl
  45. mnopqrs□tuv
  46. ```
  47. - `□` marks a box to leave out: a scribble, a speck, a stray mark.
  48. - An empty line skips a whole row. Rows past the end of the file are skipped.
  49. ```bash
  50. FF cut IMG_1.HEIC --pen blue --rows work/rows-1.txt --out work/regular
  51. ```
  52. A row whose count doesn't match is skipped with a message. Fix that line and run again. The tool sizes letters from the capitals and small letters in each photo, so photos taken from different distances match. A photo with only punctuation is sized from the ruled lines, measured on an earlier photo. On blank paper, a punctuation-only photo needs at least one letter on it as well.
  53. Use one glyph folder per weight (`work/regular`, `work/bold`). New photos merge into the folder: a character cut again replaces the old one, and everything else stays.
  54. ## 4. Check what's missing
  55. Open `work/<weight>/review.png` with the Read tool and look at every tile. Each one shows the glyph, its label and a faint blue baseline. Look for a tile that doesn't match its label, a letter floating well above or sunk below the baseline, or strokes cut off. Compare the list `cut` prints against what the user wanted.
  56. Tell the user exactly which characters to redo. They write just those on any paper, take one photo, and you cut it into the same folder. Repeat until nothing is missing or wrong. If they'd rather skip a character, that's fine. The font just won't have it.
  57. ## 5. Build the font
  58. ```bash
  59. FF build work/regular --name "Ada Hand" --style Regular --out out
  60. FF build work/bold --name "Ada Hand" --style Bold --out out
  61. ```
  62. Writes `out/AdaHand-Regular.otf` (and `-Bold`). It traces each letter into curves, sets the side spacing (`--sidebearing`, default 45 units) and adds kerning for pairs like AV, To and Ty from the actual letter shapes.
  63. ## 6. Proof sheet
  64. ```bash
  65. FF proof out/AdaHand-Regular.otf out/proof-regular.pdf # or .jpg / .png
  66. ```
  67. Shows every glyph, the tricky pairs and a few pangrams. Render a `.png` as well and look at it yourself before sending it. Check for:
  68. - letters that collide, or gaps much wider than the rest: rebuild with `--sidebearing 30` (tighter) or `60` (looser)
  69. - one letter much bigger or smaller than its neighbours, or sitting off the line: redo it (step 4)
  70. - "not in the font" characters in the output line
  71. Send the user the proof and the `.otf` files.
  72. ## 7. Help them use it
  73. **Mac:** double-click the `.otf` and press *Install* in Font Book. Or copy it to `~/Library/Fonts`.
  74. **Windows:** right-click the `.otf` and choose *Install* (or *Install for all users*).
  75. **Web:** put the files next to the CSS and add:
  76. ```css
  77. @font-face {
  78. font-family: "Ada Hand";
  79. src: url("AdaHand-Regular.otf") format("opentype");
  80. font-weight: 400;
  81. font-display: swap;
  82. }
  83. @font-face {
  84. font-family: "Ada Hand";
  85. src: url("AdaHand-Bold.otf") format("opentype");
  86. font-weight: 700;
  87. font-display: swap;
  88. }
  89. body { font-family: "Ada Hand", cursive; }
  90. ```
  91. Fill in the real font and file names. Leave out the Bold block if there's no Bold.
  92. ## Optional: a printed sheet
  93. If the user has a printer and wants the most hands-off route, there's a template with a box per character:
  94. ```bash
  95. FF template --out work --add "<extra letters>" # work/sheet-0.pdf
  96. FF extract work/template.json IMG_1.HEIC --pen blue --out work/regular
  97. FF template --out work --chars "<characters to redo>" # a retry sheet with just those
  98. ```
  99. Boxes and lines print in yellow, which the script can't see, and black corner squares let it straighten and identify each sheet. No rows file needed. `extract` writes the same glyph folder, so steps 4 to 7 are the same. Freehand and template glyphs can even go in the same folder.
  100. ## Notes
  101. - Inputs: 1 to 3 photos per weight, a font name, the pen colour. Outputs: `Name-Regular.otf`, optionally `Name-Bold.otf`, a proof PDF or image, and the CSS above.
  102. - `python test_roundtrip.py` runs both routes on fake photos, to check the setup works.
README.md · README · 56 lines
  1. # Freehandfont
  2. Turn your handwriting into a real font you can install and type with. All you need is a pen, some paper and your phone.
  3. ![My handwriting as a font](examples/proof-regular.png)
  4. It's a [Claude Code](https://claude.com/claude-code) skill. Type `/freehandfont` and Claude walks you through it: write the alphabet, send photos, get `.otf` files back.
  5. ## How it works
  6. **1. Write.** Capitals, small letters, digits and punctuation, in rows, on any paper. Ruled is fine. Leave a little space between characters. Then take a photo or two. Crossed-out bits are fine.
  7. <img src="examples/photo-page.jpg" alt="The notebook page I started from" width="420">
  8. **2. Cut.** The script finds the ink (it ignores the ruled lines), groups it into rows and boxes every character. Claude looks at the boxes and says which letter is which. Scribbles and specks get skipped.
  9. ![Every character boxed and numbered](examples/preview.png)
  10. **3. Check.** It lists what's missing or looks off. You rewrite just those on any scrap of paper and send one more photo.
  11. **4. Build.** Every letter is traced into curves and sized from your own capitals and small letters, so photos taken from different distances still match. You get an `.otf` with spacing and kerning. Write a second set with a thicker pen and you get Bold too.
  12. ![The Bold weight](examples/proof-bold.png)
  13. **5. Proof.** A sheet with every glyph and tricky pairs like "AV" and "To", so you can see spacing problems before you install.
  14. **6. Use it.** Install steps for Mac and Windows, and a `@font-face` snippet for the web.
  15. ![The font in use](examples/sample.png)
  16. ## Install the skill
  17. ```bash
  18. git clone https://github.com/MamamaMartin/freehandfont ~/.claude/skills/freehandfont
  19. ```
  20. Then type `/freehandfont` in Claude Code.
  21. ## Use it without Claude
  22. ```bash
  23. pip install -r requirements.txt
  24. python freehandfont.py cut photo.jpg --pen blue --out work/regular
  25. # open work/regular/preview-photo.png and write rows.txt: one line per row, the characters in order
  26. python freehandfont.py cut photo.jpg --pen blue --rows rows.txt --out work/regular
  27. python freehandfont.py build work/regular --name "My Hand" --out out
  28. python freehandfont.py proof out/MyHand-Regular.otf out/proof.pdf
  29. ```
  30. Prefer to print? `python freehandfont.py template --out work` makes a sheet with a box for each character, and `extract` reads it without a rows file. `python test_roundtrip.py` checks both routes on fake photos.
  31. ## Why
  32. I made a font of my own handwriting for [my site](https://martinkullander.com) and wanted anyone to be able to do the same.
  33. MIT licensed.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.