sales-amical

Name: sales-amical
Author: sales-skills

86stars9forks

How to install sales-amical?

sales-skills/sales/sales-amical

$npx -y skills add sales-skills/sales --skill sales-amical

Installs into the current project.

Summary

Amical platform help — open-source, local-first AI dictation app with Whisper STT, context-aware formatting, Ollama/OpenRouter LLM, MCP voice commands, and 100+ language support (MIT license). Use when setting up Amical on macOS or Windows for the first time, choosing between Whi

Files · 1

View on GitHub

SKILL.md

1	# Amical Platform Help
2
3	## Step 1 — Gather context
4
5	If `references/learnings.md` exists, read it first for accumulated platform knowledge.
6
7	1. What do you need help with?
8	- A) Installing Amical or first-time setup (macOS / Windows)
9	- B) Whisper model selection (Tiny through Large v3 Turbo)
10	- C) LLM configuration for text formatting (Ollama local vs OpenRouter cloud)
11	- D) Context-aware formatting not working or wrong tone
12	- E) Microphone switching or audio input issues
13	- F) Custom vocabulary for industry terminology
14	- G) Voice commands and MCP integrations
15	- H) Comparing Amical to other dictation tools
16	- I) Multi-language dictation or non-English issues
17
18	2. Which platform are you on?
19	- A) macOS
20	- B) Windows
21	- C) iOS (beta)
22	- D) Android (beta)
23
24	Skip-ahead rule: if the user's prompt already contains enough context, skip to Step 2.
25
26	## Step 2 — Route or answer directly
27
28	\| Problem domain \| Route to \|
29	\|---\|---\|
30	\| Comparing Amical to meeting note-takers \| `/sales-note-taker {user's question}` \|
31	\| Reviewing a specific call for coaching feedback \| `/sales-call-review {user's question}` \|
32	\| Building a coaching program \| `/sales-coaching {user's question}` \|
33	\| General tool integration patterns (Zapier, webhooks, iPaaS) \| `/sales-integration {user's question}` \|
34
35	When routing, provide the exact command.
36
37	## Step 3 — Amical platform reference
38
39	Read `references/platform-guide.md` for the full platform reference — modules, Whisper models, LLM providers, context-aware formatting, voice commands, MCP integration.
40
41	Answer the user's question using only the relevant section. Don't dump the full reference.
42
43	## Step 4 — Actionable guidance
44
45	You no longer need the platform guide — focus on the user's specific situation.
46
47	First-time setup priority: Install via `brew install --cask amical` (macOS) or download installer (Windows) → grant microphone + accessibility permissions → hold `fn` key and speak → text auto-pastes into active app.
48
49	Model selection: Tiny (78 MB) for speed-first. Base (148 MB) for balanced. Small (488 MB) for most users. Medium (1.5 GB) for high accuracy. Large v3 Turbo (1.5 GB) for near-max accuracy at faster speed. Large v3 (3.1 GB) for highest accuracy.
50
51	Fully offline setup: Download a Whisper model + configure Ollama for local LLM text formatting. No cloud calls, no API keys needed.
52
53	Context-aware formatting: Requires an LLM model configured (Ollama or OpenRouter). Without it, you get raw transcription only — no tone/format adaptation.
54
55	If you discover a gotcha, workaround, or tip not covered in `references/learnings.md`, append it there.
56
57	## Gotchas
58
59	- Context-aware formatting requires LLM configuration — many users expect formatting to work out of the box. Without Ollama or OpenRouter configured, Amical outputs raw Whisper transcription with no formatting, grammar correction, or tone adaptation.
60	- Cannot switch microphones in-app (GitHub #137) — the microphone selection UI doesn't work on some systems. Workaround: set preferred mic as system default in OS settings.
61	- Japanese and non-English text formatting issues — reported style/language changes (#111) and punctuation insertion problems (#88) for CJK languages. English formatting is most reliable.
62	- Non-QWERTY keyboard layouts may conflict — shortcut keys can collide with non-standard layouts (#89). Test your hotkey configuration after setup.
63	- Real-time meeting transcription is planned, not shipped — Amical is a dictation tool (hold-to-speak), not a continuous meeting recorder. If you need passive meeting recording, use a dedicated note-taker (Fathom, Meetily, Char).
64	- No public API, no webhooks, no CRM integration — Amical is a local desktop app. No programmatic access to transcription history beyond the app UI.
65	- MCP voice commands are planned, not shipped — the

People who liked this also viewed

6 picks

Type

sales-amical

86stars9forks

View on GitHub

How to install sales-amical?

sales-skills/sales/sales-amical

$npx -y skills add sales-skills/sales --skill sales-amical

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Amical Platform Help
2
3	## Step 1 — Gather context
4
5	If `references/learnings.md` exists, read it first for accumulated platform knowledge.
6
7	1. What do you need help with?
8	- A) Installing Amical or first-time setup (macOS / Windows)
9	- B) Whisper model selection (Tiny through Large v3 Turbo)
10	- C) LLM configuration for text formatting (Ollama local vs OpenRouter cloud)
11	- D) Context-aware formatting not working or wrong tone
12	- E) Microphone switching or audio input issues
13	- F) Custom vocabulary for industry terminology
14	- G) Voice commands and MCP integrations
15	- H) Comparing Amical to other dictation tools
16	- I) Multi-language dictation or non-English issues
17
18	2. Which platform are you on?
19	- A) macOS
20	- B) Windows
21	- C) iOS (beta)
22	- D) Android (beta)
23
24	Skip-ahead rule: if the user's prompt already contains enough context, skip to Step 2.
25
26	## Step 2 — Route or answer directly
27
28	\| Problem domain \| Route to \|
29	\|---\|---\|
30	\| Comparing Amical to meeting note-takers \| `/sales-note-taker {user's question}` \|
31	\| Reviewing a specific call for coaching feedback \| `/sales-call-review {user's question}` \|
32	\| Building a coaching program \| `/sales-coaching {user's question}` \|
33	\| General tool integration patterns (Zapier, webhooks, iPaaS) \| `/sales-integration {user's question}` \|
34
35	When routing, provide the exact command.
36
37	## Step 3 — Amical platform reference
38
39	Read `references/platform-guide.md` for the full platform reference — modules, Whisper models, LLM providers, context-aware formatting, voice commands, MCP integration.
40
41	Answer the user's question using only the relevant section. Don't dump the full reference.
42
43	## Step 4 — Actionable guidance
44
45	You no longer need the platform guide — focus on the user's specific situation.
46
47	First-time setup priority: Install via `brew install --cask amical` (macOS) or download installer (Windows) → grant microphone + accessibility permissions → hold `fn` key and speak → text auto-pastes into active app.
48
49	Model selection: Tiny (78 MB) for speed-first. Base (148 MB) for balanced. Small (488 MB) for most users. Medium (1.5 GB) for high accuracy. Large v3 Turbo (1.5 GB) for near-max accuracy at faster speed. Large v3 (3.1 GB) for highest accuracy.
50
51	Fully offline setup: Download a Whisper model + configure Ollama for local LLM text formatting. No cloud calls, no API keys needed.
52
53	Context-aware formatting: Requires an LLM model configured (Ollama or OpenRouter). Without it, you get raw transcription only — no tone/format adaptation.
54
55	If you discover a gotcha, workaround, or tip not covered in `references/learnings.md`, append it there.
56
57	## Gotchas
58
59	- Context-aware formatting requires LLM configuration — many users expect formatting to work out of the box. Without Ollama or OpenRouter configured, Amical outputs raw Whisper transcription with no formatting, grammar correction, or tone adaptation.
60	- Cannot switch microphones in-app (GitHub #137) — the microphone selection UI doesn't work on some systems. Workaround: set preferred mic as system default in OS settings.
61	- Japanese and non-English text formatting issues — reported style/language changes (#111) and punctuation insertion problems (#88) for CJK languages. English formatting is most reliable.
62	- Non-QWERTY keyboard layouts may conflict — shortcut keys can collide with non-standard layouts (#89). Test your hotkey configuration after setup.
63	- Real-time meeting transcription is planned, not shipped — Amical is a dictation tool (hold-to-speak), not a continuous meeting recorder. If you need passive meeting recording, use a dedicated note-taker (Fathom, Meetily, Char).
64	- No public API, no webhooks, no CRM integration — Amical is a local desktop app. No programmatic access to transcription history beyond the app UI.
65	- MCP voice commands are planned, not shipped — the

People who liked this also viewed

6 picks

Type