@hasna/skills 0.0.2

package/skills/skill-generate-documentation/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "moduleResolution": "bundler",
+    "esModuleInterop": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "outDir": "dist",
+    "declaration": true,
+    "types": ["bun-types"]
+  },
+  "include": ["src/**/*", "bin/**/*"]
+}

package/skills/skill-generate-docx/CLAUDE.md

@@ -0,0 +1,19 @@
+# skill-generate-docx
+
+Generate DOCX documents.
+
+## Development
+
+- Runtime: Bun
+- Use `bun` instead of `npm`, `yarn`, or `pnpm`
+- Use `bun run` instead of `npm run`
+- Use `bun install` instead of `npm install`
+
+## Commands
+
+```bash
+bun install        # Install dependencies
+bun run start      # Run the skill
+bun run dev        # Run with watch mode
+bun run cli        # Run via CLI
+```

package/skills/skill-generate-docx/SKILL.md

@@ -0,0 +1,295 @@
+---
+name: Generate Docx
+version: 1.0.0
+description: Generate docx with customizable options
+author: skills.md
+category: Documentation
+tags:
+  - documentation
+  - markdown
+  - ai
+---
+--topic "Project Proposal for Mobile App Development" -o proposal.docx
+
+# Generate DOCX
+
+Create professional Microsoft Word documents from markdown content, plain text, or let AI generate complete documents from a topic or outline.
+
+> **This is a CLI skill.** It requires the `skills` CLI to execute. Install it with `npm install -g @hasna/skills`, then run the commands below.
+
+## Features
+
+- **Markdown to DOCX**: Convert markdown files to Word documents
+- **AI Generation**: Generate complete documents from topics/prompts
+- **Rich Formatting**: Headers, lists, tables, code blocks, quotes
+- **Custom Styling**: Fonts, colors, margins, spacing
+- **Templates**: Professional templates (report, letter, memo, resume)
+- **Table of Contents**: Auto-generated TOC
+- **Headers/Footers**: Page numbers, dates, custom text
+- **Images**: Embed images from local files or URLs
+
+## Installation
+
+```bash
+skills install generate-docx
+```
+
+## Quick Start
+
+### From Markdown
+
+```bash
+# Convert markdown to Word
+skills run generate-docx -- document.md -o output.docx
+
+# With custom styling
+skills run generate-docx -- document.md --template report --font "Times New Roman"
+```
+
+### AI Generation
+
+```bash
+# Generate from topic
+skills run generate-docx -- --topic "Project Proposal for Mobile App Development" -o proposal.docx
+
+# With more control
+skills run generate-docx -- --topic "Employee Handbook" \
+  --sections 10 \
+  --style formal \
+  --template report \
+  -o handbook.docx
+```
+
+### From Text/Prompt
+
+```bash
+# Generate from prompt
+skills run generate-docx -- --prompt "Write a cover letter for a software engineer position at Google" -o cover-letter.docx
+```
+
+## Options
+
+### Input Options
+
+| Flag              | Description                     |
+| ----------------- | ------------------------------- |
+| `<file>`          | Input markdown file             |
+| `--topic <text>`  | Topic for AI to write about     |
+| `--prompt <text>` | Direct prompt for AI generation |
+| `--text <text>`   | Plain text content              |
+
+### AI Options
+
+| Flag              | Default      | Description                                   |
+| ----------------- | ------------ | --------------------------------------------- |
+| `--sections <n>`  | 5            | Number of sections to generate                |
+| `--style <type>`  | professional | Style: professional, casual, formal, academic |
+| `--tone <type>`   | neutral      | Tone: neutral, friendly, authoritative        |
+| `--length <type>` | medium       | Length: short, medium, long, comprehensive    |
+
+### Output Options
+
+| Flag                  | Default         | Description      |
+| --------------------- | --------------- | ---------------- |
+| `-o, --output <path>` | auto            | Output file path |
+| `--dir <path>`        | .skills/exports | Output directory |
+
+### Template Options
+
+| Flag                | Default | Description                                              |
+| ------------------- | ------- | -------------------------------------------------------- |
+| `--template <name>` | default | Template: default, report, letter, memo, resume, article |
+| `--title <text>`    | auto    | Document title                                           |
+| `--author <text>`   | -       | Author name                                              |
+| `--company <text>`  | -       | Company name                                             |
+| `--date <text>`     | today   | Document date                                            |
+
+### Styling Options
+
+| Flag                    | Default       | Description             |
+| ----------------------- | ------------- | ----------------------- |
+| `--font <name>`         | Calibri       | Font family             |
+| `--font-size <pt>`      | 11            | Base font size          |
+| `--heading-font <name>` | Calibri Light | Heading font            |
+| `--line-spacing <n>`    | 1.15          | Line spacing multiplier |
+| `--margins <inches>`    | 1             | Page margins            |
+| `--page-size <size>`    | letter        | Page: letter, a4, legal |
+
+### Content Options
+
+| Flag              | Default | Description               |
+| ----------------- | ------- | ------------------------- |
+| `--toc`           | false   | Include table of contents |
+| `--page-numbers`  | true    | Include page numbers      |
+| `--header <text>` | -       | Header text               |
+| `--footer <text>` | -       | Footer text               |
+
+## Templates
+
+### default
+
+Clean, minimal document with standard formatting.
+
+### report
+
+Professional report with title page, TOC, headers/footers.
+
+### letter
+
+Business letter format with date, addresses, signature block.
+
+### memo
+
+Internal memo format with To/From/Subject/Date header.
+
+### resume
+
+CV/Resume format with sections for experience, education, skills.
+
+### article
+
+Article/essay format with abstract and section numbering.
+
+## Examples
+
+### Example 1: Simple Markdown Conversion
+
+```bash
+skills run generate-docx -- notes.md -o notes.docx
+```
+
+### Example 2: Professional Report
+
+```bash
+skills run generate-docx -- \
+  --topic "Q4 2024 Sales Analysis" \
+  --template report \
+  --sections 8 \
+  --style formal \
+  --toc \
+  --author "Sales Team" \
+  --company "Acme Corp" \
+  -o q4-report.docx
+```
+
+### Example 3: Business Letter
+
+```bash
+skills run generate-docx -- \
+  --prompt "Write a business letter declining a partnership offer politely" \
+  --template letter \
+  --author "John Smith" \
+  --company "Tech Solutions Inc" \
+  -o decline-letter.docx
+```
+
+### Example 4: Resume from Markdown
+
+```bash
+skills run generate-docx -- resume.md \
+  --template resume \
+  --font "Garamond" \
+  --margins 0.75 \
+  -o my-resume.docx
+```
+
+### Example 5: Academic Paper
+
+```bash
+skills run generate-docx -- paper.md \
+  --template article \
+  --font "Times New Roman" \
+  --font-size 12 \
+  --line-spacing 2 \
+  --toc \
+  -o research-paper.docx
+```
+
+### Example 6: Company Memo
+
+```bash
+skills run generate-docx -- \
+  --prompt "Write a memo announcing the new remote work policy" \
+  --template memo \
+  --author "HR Department" \
+  -o remote-work-memo.docx
+```
+
+## Markdown Support
+
+The skill supports standard markdown plus extensions:
+
+```markdown
+# Heading 1
+
+## Heading 2
+
+### Heading 3
+
+Regular paragraph text with **bold**, _italic_, and `code`.
+
+- Bullet list item 1
+- Bullet list item 2
+  - Nested item
+
+1. Numbered list
+2. Second item
+
+> Block quote text
+
+| Column 1 | Column 2 |
+| -------- | -------- |
+| Cell 1   | Cell 2   |
+
+![Image](path/to/image.png)
+
+---
+
+Horizontal rule above
+```
+
+## Environment Variables
+
+```bash
+# Required for AI generation
+export OPENAI_API_KEY="sk-..."
+```
+
+## Credits
+
+- Base conversion: 3 credits
+- AI generation: +5 credits
+
+## Troubleshooting
+
+**Document won't open**
+
+- Ensure .docx extension is used
+- Try opening in Google Docs or LibreOffice
+
+**Formatting looks wrong**
+
+- Different Word versions render slightly differently
+- Try adjusting font and spacing options
+
+**Images not appearing**
+
+- Use absolute paths for local images
+- Ensure image files exist
+
+**AI generation failed**
+
+- Check OPENAI_API_KEY is set
+- Use markdown input instead of --topic
+
+## Related Skills
+
+- `generate-pdf` - Create PDF documents
+- `generate-slides` - Create presentations
+- `parse-pdf` - Extract content from PDFs
+
+## Support
+
+For issues or feature requests, visit [skills.md/skills/generate-docx](https://skills.md/skills/generate-docx)
+
+```

package/skills/skill-generate-docx/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@hasnaxyz/skill-generate-docx",
+  "version": "0.1.0",
+  "description": "Generate DOCX documents",
+  "type": "module",
+  "bin": {
+    "skill-generate-docx": "./bin/cli.ts"
+  },
+  "scripts": {
+    "start": "bun run src/index.ts",
+    "dev": "bun run --watch src/index.ts",
+    "cli": "bun run bin/cli.ts"
+  },
+  "dependencies": {
+    "commander": "^13.1.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "restricted"
+  }
+}