Add mascot pattern generator script

README.md

@@ -47,3 +47,11 @@ To run the project, call the following:
 ```
 python banana.py    # may need to use python3 if on Mac or Windows
 ```
+
+## Mascot pattern generator
+
+Generate a Markdown crochet or knitting pattern:
+
+```
+perl scripts/generate_mascot_pattern.pl --banana 3 --goose 1 --goblin 2 --yarn dk --height 22 --terminology uk --emoji --output mascot.md
+```

docs/mascot-pattern-generator.md

@@ -0,0 +1,19 @@
+# Mascot Pattern Generator
+
+`scripts/generate_mascot_pattern.pl` creates a Markdown craft pattern for a project mascot.
+
+Example:
+
+```sh
+perl scripts/generate_mascot_pattern.pl --banana 3 --goose 1 --goblin 2 --yarn dk --height 22 --terminology uk --emoji --output mascot.md
+```
+
+The generator supports:
+
+- relative feature ratios with `--banana`, `--goose`, and `--goblin`
+- `crochet` or `knit` instructions through `--craft`
+- US or UK crochet stitch terminology through `--terminology`
+- emoji instructions instead of English prose through `--emoji`
+- yarn-weight scaling through `--yarn`
+- finished-size scaling through `--height`
+- stdout output or file output through `--output`