Skip to content

mloki23/ai-translator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AI Translator

An agent skill that delivers a $997-tier AI consulting engagement for free. Audits a small business's workflows, researches industry-specific tools, scores every opportunity by ROI, and delivers a concrete AI Implementation Playbook — the kind consultants charge thousands for.

Author: mloki23 Version: 1.0.0 License: MIT


What It Does

AI Translator conducts a structured 6-phase engagement with a small business owner:

  1. Business Discovery — builds a complete business profile
  2. Workflow Deep-Dive — maps every repeatable process across 6 functional areas
  3. Pain Point Quantification — attaches real dollar costs to the biggest friction points
  4. AI Opportunity Research — finds industry-specific tools with verified pricing and user reviews
  5. Playbook Assembly — produces a ranked, priced, 90-day AI implementation plan
  6. Delivery & Handoff — presents findings and ensures the owner knows their first action step

The deliverable is a saved Markdown file: AI-Playbook-[Business-Name]-[Date].md


The Four-Skill Pipeline

AI Translator is the fourth and highest-value skill in a consulting pipeline:

Market Gap Finder → Side Hustle Evaluator → Competitor Intel Briefer → AI Translator
  • Market Gap Finder — identifies underserved market opportunities in a niche
  • Side Hustle Evaluator — scores business ideas by viability and income potential
  • Competitor Intel Briefer — produces a competitive landscape briefing
  • AI Translator ← you are here — the implementation skill that turns analysis into action

Clients who run earlier skills in the pipeline arrive at AI Translator with clearer business goals and higher confidence in the process.


Installation

Claude Code

# Install to your local skills directory
mkdir -p ~/.claude/skills/ai-translator
cp -r . ~/.claude/skills/ai-translator/

Load the skill in a session:

/skill ai-translator

Or reference it in your CLAUDE.md:

## Skills
Available skill: ai-translator (see ~/.claude/skills/ai-translator/SKILL.md)

Hermes Agent

hermes chat -s ai-translator

Hermes auto-loads SKILL.md and makes linked reference files accessible via skill_view().

VS Code Copilot / GitHub Copilot

Add the SKILL.md content to your workspace instructions or custom system prompt. Reference files must be manually loaded or copied into context as needed.

Codex / OpenAI Agents

Inject the SKILL.md content into the system prompt. The agent will follow the 6-phase engagement structure. Reference files can be loaded via the file tool or injected into context at the relevant phase.

Manual (Any Agent)

Copy the content of SKILL.md into your system prompt or agent instructions. The skill is implementation-agnostic — any capable language model will follow it.


File Structure

ai-translator/
├── SKILL.md                                    # Core skill — load this
├── README.md                                   # This file
├── LICENSE                                     # MIT
│
├── references/
│   ├── playbook-template-full.md               # The deliverable template (mandatory)
│   ├── solution-library.md                     # Curated workflow → tool mappings
│   ├── pricing-database.md                     # Top 30 AI tools, AUD pricing
│   ├── common-traps.md                         # Industry-specific AI warnings
│   └── industry-question-banks/
│       ├── hospitality.md                      # Cafes, restaurants, bars
│       ├── trades-construction.md              # Electricians, builders, plumbers
│       └── professional-services.md            # Consultants, accountants, lawyers
│
├── scripts/
│   └── validate-playbook.py                    # Quality gate script
│
└── assets/
    └── example-playbook-hospitality.md         # Redacted sales example

Reference Files

The SKILL.md instructs the agent to load reference files at specific phases:

File When Loaded Purpose
industry-question-banks/[industry].md Phase 2 Industry-specific probing questions
solution-library.md Phase 4 Starting point for tool research
pricing-database.md Phase 4 AUD pricing reference (verify live)
playbook-template-full.md Phase 5 Mandatory playbook structure
common-traps.md Phase 5 Industry-specific AI warnings

Reference files are loaded on-demand to stay within context budget.


Quality Validation

After generating a playbook, validate it before delivery:

python scripts/validate-playbook.py AI-Playbook-BusinessName-2026-04-26.md

# Strict mode (also checks for user quotes per recommendation)
python scripts/validate-playbook.py AI-Playbook-BusinessName-2026-04-26.md --strict

The validator checks:

  • All required sections are present
  • Recommendations have pricing, time savings, and URLs
  • Quick Wins include free items
  • 90-day roadmap has specific actions
  • No generic language ("use AI tools" without specifics)
  • Currency is specified
  • No unfilled placeholder text
  • File naming convention

Pricing Database

references/pricing-database.md covers 30+ tools including:

  • AI Assistants (ChatGPT, Claude, Gemini)
  • Accounting (Xero, MYOB, QuickBooks)
  • Automation (Zapier, Make, n8n)
  • CRM & Communication (HubSpot, Zoho, Tidio, Intercom)
  • Social Media (Buffer, Later, Hootsuite)
  • HR & Rostering (Employment Hero, Deputy, Tanda)
  • Field Service (ServiceM8, Tradify, Jobber)
  • And more

Pricing is AUD and verified as of April 2026. Always confirm current pricing on the vendor's website before making a recommendation. Prices change frequently.


Locale Awareness

AI Translator is not hardcoded to Australia. The skill instructs the agent to:

  • Detect the business's country from Phase 1
  • Quote all prices in the local currency
  • Reference the appropriate local tax and compliance system (GST/BAS for AU, VAT for UK, etc.)

The pricing database is AUD-primary but includes USD references for cross-checking.


Engagement Triggers

The skill activates when a user says any of:

  • "I want an AI audit for my business"
  • "Show me where AI can save me time"
  • "What AI tools should I be using?"
  • "Audit my business for AI opportunities"
  • "Run the AI Translator"

Example Output

See assets/example-playbook-hospitality.md for a redacted example playbook from a Melbourne cafe engagement. The example demonstrates the specificity, structure, and depth expected in a live engagement.


Maintaining the Pricing Database

Tool pricing changes frequently. Review and update references/pricing-database.md monthly.

For each tool, check the vendor's pricing page and update:

  • The Last Updated date at the top of the file
  • Any changed prices
  • New tools added to the relevant categories
  • Any tools that have been discontinued

A stale pricing database is worse than no database — it produces incorrect recommendations.


Contributing

Improvements welcome:

  • Additional industry question banks (healthcare, retail, creative agencies)
  • Pricing database updates (monthly)
  • Additional common traps by industry
  • Example playbooks from other verticals

License

MIT License. See LICENSE for details.

About

AI agent skill that audits small business workflows and delivers an AI implementation playbook. No API keys needed.

Topics

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages