Rename claude-code/ to skills/ and add Homebrew caveats

- Rename SKILL.md to skills/fastmail.md
- Update goreleaser to install skill file to share/fm/
- Add post-install caveats showing symlink command for Claude Code
- Update README with correct paths for both Homebrew and manual install
- Document --json fields syntax and additional search operators in skill

Author: marckohlbrugge

.goreleaser.yml

@@ -35,6 +35,7 @@ archives:
     files:
       - LICENSE*
       - README*
+      - skills/fastmail.md
 
 checksum:
   name_template: "checksums.txt"
@@ -57,5 +58,10 @@ brews:
     license: MIT
     install: |
       bin.install "fm"
+      (share/"fm").install "skills/fastmail.md"
     test: |
       system "#{bin}/fm", "version"
+    caveats: |
+      To use fm with Claude Code, create a symlink to the skill file:
+        mkdir -p ~/.claude/commands
+        ln -sf #{share}/fm/fastmail.md ~/.claude/commands/fastmail.md

README.md

@@ -138,19 +138,26 @@ Example JSON output:
 
 ## Claude Code Integration
 
-If you use [Claude Code](https://docs.anthropic.com/en/docs/claude-code), you can add the included skill to let Claude manage your email:
+If you use [Claude Code](https://docs.anthropic.com/en/docs/claude-code), you can add the included skill to let Claude manage your email.
 
+**If installed via Homebrew:**
 ```bash
-mkdir -p ~/.claude/skills
-cp claude-code/SKILL.md ~/.claude/skills/fastmail.md
+mkdir -p ~/.claude/commands
+ln -sf $(brew --prefix)/share/fm/fastmail.md ~/.claude/commands/fastmail.md
+```
+
+**If installed manually:**
+```bash
+mkdir -p ~/.claude/commands
+ln -sf /path/to/fastmail-cli/skills/fastmail.md ~/.claude/commands/fastmail.md
 ```
 
 Then ask Claude things like:
 - "Check my inbox for unread emails"
 - "Search for emails from Alice about the project"
 - "Draft a reply to the last email from Bob"
 
-See [claude-code/SKILL.md](claude-code/SKILL.md) for the full command reference.
+See [skills/fastmail.md](skills/fastmail.md) for the full command reference.
 
 ## Authentication
 

claude-code/SKILL.md skills/fastmail.mdclaude-code/SKILL.md renamed to skills/fastmail.md

@@ -42,20 +42,33 @@ What would you like to do?
 ```bash
 # List recent inbox emails
 fm inbox
+fm inbox --limit 10
+
+# JSON output with specific fields
+fm inbox --json id,subject,from
 
 # Search emails (returns up to 50 by default)
 fm search "query"
 fm search "query" --limit 100
 fm search "query" --folder inbox
-fm search "query" --json
+
+# Search with JSON output
+fm search "query" --json id,subject,from,date
 ```
 
+**Available JSON fields:** `id`, `threadId`, `subject`, `from`, `to`, `cc`, `date`, `preview`, `unread`, `attachment`
+
 **Search operators:**
 - `from:alice` - Emails from alice
 - `to:bob` - Emails to bob
 - `subject:hello` - Subject contains hello
 - `has:attachment` - Has attachments
 - `is:unread` - Unread emails only
+- `is:flagged` - Flagged/starred emails
+- `before:YYYY-MM-DD` - Emails before date
+- `after:YYYY-MM-DD` - Emails after date
+
+**Boolean operators:** `AND`, `OR`, `NOT`, `()` for grouping
 
 ### Reading Emails