🎨 The Visual Repo

Turn any GitHub project into your personal AI assistant — no code required.

---

graph LR
    A["📦 GitHub Project"] -->|"+ AI Tool"| B["🤖 Your Personal<br/>AI Assistant"]
    B --> C["🔗 Connected to<br/>Your Sales Tools"]

    style A fill:#a29bfe,color:#fff,stroke:none
    style B fill:#00b894,color:#fff,stroke:none
    style C fill:#0984e3,color:#fff,stroke:none

Loading

Find a tool. Create an AI assistant from it. Connect it to your workflow.
No coding. No terminal. Just your browser and an AI chat.

---

📍 You're Here Because...

Someone sent you a GitHub link — or you found one yourself — and you want to actually use it. Not just read about it. Use it. Every day. Connected to the tools you already work in.

This page shows you how to go from "I don't understand GitHub" to "I have a custom AI assistant that researches prospects for me" — in about 15 minutes.

---

🎯 Pick Your AI Tool

You only need one. Whichever you already use:

ChatGPT Create a GPT →

Claude Create a Project →

Perplexity Create a Space →

Gemini Create a Gem →

Other AI Universal Method →

---

🗺️ The Big Picture

Here's everything you're about to do. It's simpler than it looks:

graph TD
    A["1️⃣ FIND<br/>Find a useful project<br/>on GitHub"] --> B["2️⃣ GRAB<br/>Copy the SKILL.md<br/>or README"]
    B --> C["3️⃣ CREATE<br/>Make a Custom GPT,<br/>Claude Project, or<br/>Perplexity Space"]
    C --> D["4️⃣ TEACH<br/>Paste the skill into<br/>your AI assistant"]
    D --> E["5️⃣ USE<br/>Talk to your assistant<br/>like a coworker"]
    E --> F["6️⃣ CONNECT<br/>Link it to Salesforce,<br/>HubSpot, Clay, etc."]

    style A fill:#a29bfe,color:#fff,stroke:none
    style B fill:#6c5ce7,color:#fff,stroke:none
    style C fill:#fd79a8,color:#fff,stroke:none
    style D fill:#e17055,color:#fff,stroke:none
    style E fill:#00b894,color:#fff,stroke:none
    style F fill:#0984e3,color:#fff,stroke:none

Loading

---

---

🟢 Level 1 — Understand GitHub in 2 Minutes

---

What Is GitHub?

A website where people share free tools. That's it. Like an app store, except everything is free and you can see how it's built.

What's a README?

The page you see when you open a project. It's the instructions. You're reading one right now.

What's a SKILL.md?

An instruction manual written for AI. When you give this file to ChatGPT or Claude, your AI instantly becomes an expert on that tool.

What's a REPO_MANIFEST.yml?

A structured summary of the entire project. Think of it as the nutrition label. Hand it to any AI tool and ask "what does this project do?" — you'll get a perfect answer every time.

Five Words That Unlock GitHub

Word	What It Means	Real-World Equivalent
Repo	A project folder	A folder on your computer
README	The welcome page	The back of a cereal box
Clone	Download a copy	Saving a Google Doc to your computer
Commit	Save your changes	Hitting "Save" in Word
Branch	A separate copy to experiment with	A rough draft

The 30-Second Test

Want to see if you get it? Try this right now:

1. Go to github.com/MahoneyContextProtocol/claude-cleanup
2. Read the first 3 paragraphs of the README
3. Look at the colorful diagram at the top
4. You now understand that project. See? Not scary.

---

---

🔵 Level 2 — Create Your AI Assistant

This is the main event. Pick your AI tool and follow the steps.

---

💬 ChatGPT — Create a Custom GPT

A Custom GPT is a version of ChatGPT that's pre-loaded with specific knowledge. Once you create it, you can talk to it forever — it already knows the tool.

Steps:

1. Go to chat.openai.com/gpts/editor (you need ChatGPT Plus)

2. Name it something you'll remember

   Example: "Prospect Research Assistant"

3. In the Instructions box, paste this starter prompt:

   You are my personal assistant for [describe your use case].
   
   I'm going to give you a skill file from a GitHub project. 
   Learn it completely. Then help me use it in my daily work.
   
   My role: [your job title]
   Tools I use: [Salesforce / HubSpot / SalesLoft / Clay / etc.]
   My goal: [what you want to accomplish]
   
   Always explain things simply. I'm not technical.
   When suggesting workflows, connect them to my existing tools.
   

4. In the Knowledge section, upload the SKILL.md file from the GitHub project

   • Go to the GitHub project
   • Click on SKILL.md
   • Click the download button (↓ icon) or copy all the text
   • Upload it to your GPT's Knowledge section

5. Click Save → Choose "Only me" or "Anyone with a link"

6. Start chatting. Your GPT now knows the tool. Ask it anything:

   "How do I use this to research prospects before cold calls?" "Build me a morning routine using this tool and Salesforce" "Connect this to my HubSpot workflow"

graph LR
    A["📋 Copy SKILL.md<br/>from GitHub"] --> B["⚙️ Create GPT<br/>at chat.openai.com"]
    B --> C["📎 Upload SKILL.md<br/>as Knowledge"]
    C --> D["💬 Chat with your<br/>new expert assistant"]

    style A fill:#6c5ce7,color:#fff,stroke:none
    style B fill:#a29bfe,color:#fff,stroke:none
    style C fill:#fd79a8,color:#fff,stroke:none
    style D fill:#00b894,color:#fff,stroke:none

Loading

---

🟠 Claude — Create a Project

A Claude Project is a workspace where Claude remembers context between conversations. It's perfect for building persistent assistants.

Steps:

1. Go to claude.ai → Click Projects in the sidebar → New Project

2. Name it

   Example: "Sales Research Assistant"

3. Add a Project Description (this tells Claude its role):

   You are my personal assistant for sales prospecting and research.
   
   My role: [your job title, e.g., "SDR at a SaaS company"]
   Tools I use daily: [Salesforce / HubSpot / SalesLoft / Clay / LinkedIn Sales Nav]
   My goal: [e.g., "Research prospects quickly before cold calls"]
   
   Always explain things simply. I'm not technical.
   When suggesting workflows, connect them to my existing tools.
   Suggest specific actions I can take right now.
   

4. Add Knowledge → Click "Add content" → Upload or paste the SKILL.md file from the GitHub project

5. Also add the REPO_MANIFEST.yml if the project has one (this gives Claude structured data about the tool)

6. Start a conversation inside the project. Claude now knows the tool permanently:

   "What does this tool do and how can I use it for prospect research?" "Build me a workflow that combines this with my Salesforce process" "I have a call with [Company] in 10 minutes — help me prep"

graph LR
    A["📋 Copy SKILL.md<br/>from GitHub"] --> B["📂 Create Project<br/>at claude.ai"]
    B --> C["📎 Add SKILL.md<br/>to Project Knowledge"]
    C --> D["💬 Every conversation<br/>in this project<br/>has full context"]

    style A fill:#6c5ce7,color:#fff,stroke:none
    style B fill:#a29bfe,color:#fff,stroke:none
    style C fill:#fd79a8,color:#fff,stroke:none
    style D fill:#00b894,color:#fff,stroke:none

Loading

---

🟣 Perplexity — Create a Space

Perplexity Spaces let you create focused research areas with custom instructions and sources.

Steps:

1. Go to perplexity.ai → Spaces → Create Space

2. Name it and add a description

   Example: "Prospect Research" / "Pre-call research using AI tools"

3. In the Custom Instructions, paste:

   I'm a [job title] at [company]. I use [your tools: Salesforce, HubSpot, etc.].
   
   Help me use GitHub tools for my sales workflow.
   Always explain simply — I'm not technical.
   Give me actionable steps connected to my existing tools.
   

4. Add the SKILL.md as a source — paste the text into the Space's context or upload the file

5. Search and chat inside the Space. Perplexity will combine its web search with your tool knowledge:

   "Research [Company Name] and tell me what I should know before my call, using the approach from my skill file"

---

🔴 Gemini — Create a Gem

Google Gems are custom Gemini assistants with persistent instructions.

Steps:

1. Go to gemini.google.com → Gem Manager → Create Gem

2. Paste the SKILL.md contents into the Gem's instructions

3. Add your role context:

   "I'm a [title]. Help me use this tool with [my existing tools]. Keep it simple."

4. Save and start chatting with your Gem

---

🌐 Any AI Tool — The Universal Method

If your AI tool doesn't have custom assistants, you can still use the Persistent Prompt Method:

1. Save this text somewhere you can copy it quickly (Google Doc, Notion, Notes app):

   === MY AI ASSISTANT CONTEXT ===
   
   My role: [your job title]
   My tools: [list your daily tools]
   My goal: [what you want help with]
   
   Below is a skill file from a GitHub tool I want to use.
   Help me apply it to my daily workflow.
   Always explain simply — I'm not technical.
   
   === SKILL FILE ===
   [paste SKILL.md contents here]
   

2. Every time you start a new chat, paste this at the beginning

3. Then ask your question

It's not as clean as a Custom GPT or Claude Project, but it works with any AI tool — Microsoft Copilot, Mistral, Grok, you name it.

---

---

🟡 Level 3 — Connect to Your Sales Tools

This is where it gets powerful.

---

The Integration Map

graph TD
    AI["🤖 Your AI Assistant<br/>(GPT / Claude Project / Gem)"] --> SF["Salesforce<br/><i>Update records, log calls,<br/>pull account data</i>"]
    AI --> HS["HubSpot<br/><i>Contact enrichment,<br/>sequence triggers</i>"]
    AI --> SL["SalesLoft / Outreach<br/><i>Personalize cadences,<br/>research before steps</i>"]
    AI --> CL["Clay<br/><i>Prospect enrichment,<br/>waterfall research</i>"]
    AI --> LI["LinkedIn Sales Nav<br/><i>Profile research,<br/>connection notes</i>"]
    AI --> SH["Google Sheets<br/><i>Pipeline tracking,<br/>research databases</i>"]

    style AI fill:#6c5ce7,color:#fff,stroke:none
    style SF fill:#0984e3,color:#fff,stroke:none
    style HS fill:#e17055,color:#fff,stroke:none
    style SL fill:#00b894,color:#fff,stroke:none
    style CL fill:#fd79a8,color:#fff,stroke:none
    style LI fill:#0984e3,color:#fff,stroke:none
    style SH fill:#00b894,color:#fff,stroke:none

Loading

How Integrations Work

You don't connect tools by writing code. You connect them by describing workflows to your AI assistant. The AI figures out the steps.

Salesforce

Ask your AI assistant:

"I just got off a call with [prospect]. Help me write a Salesforce activity note that includes: key pain points discussed, next steps, and a follow-up task for next Tuesday."

"Pull up what we know about [Company] from our Salesforce records and combine it with what you can research online. I have a call in 15 minutes."

For ChatGPT with Salesforce plugin: Enable the Salesforce plugin in your Custom GPT settings. Your GPT can then read and write Salesforce data directly.

For Claude with MCP: If your company uses Claude with Salesforce MCP connector, your Claude Project can access Salesforce data directly.

HubSpot

"I need to send a follow-up sequence to the 12 leads from last week's webinar. Draft 3 personalized email variations I can paste into HubSpot sequences."

"Look at my HubSpot contact list for [segment] and help me prioritize who to call first based on engagement signals."

SalesLoft / Outreach

"I'm on step 3 of my SalesLoft cadence for [prospect]. Research their company and help me personalize this touchpoint."

"Write me 5 variations of a cold email for [persona] that I can A/B test in Outreach."

Clay

"I have a Clay table of 200 prospects. Help me write a formula column that categorizes them by likely pain point based on company size and industry."

"Build me a Clay enrichment workflow that takes a company name and returns: recent funding, tech stack, and hiring signals."

LinkedIn Sales Navigator

"I'm about to send an InMail to [prospect]. Research their profile, recent posts, and company news. Help me write a message that references something specific."

"I found 30 results in Sales Nav for [search]. Help me narrow to the 10 most likely to respond based on their activity signals."

---

Pre-Built Workflow Templates

Copy any of these prompts into your AI assistant to get started immediately:

🔥 Pre-Call Research (2 minutes)

Paste into your Custom GPT / Claude Project:

I have a call with [PROSPECT NAME] at [COMPANY] in [X] minutes.

Research them and give me:
1. Company overview (1 sentence)
2. Recent news (last 90 days)
3. Their likely pain points based on their role and industry
4. One specific thing I can reference to show I did my homework
5. Two discovery questions tailored to their situation

Keep it to one screen. I need to read this in 60 seconds.

📧 Personalized Cold Email (30 seconds per prospect)

Write a cold email to [NAME], [TITLE] at [COMPANY].

About my product: [one sentence about what you sell]
Their likely pain point: [your best guess]
Tone: Casual, peer-to-peer, not salesy
Length: Under 100 words
CTA: Soft ask for a 15-minute call

Include one specific detail about their company or role 
that shows this isn't a mass email.

📊 Weekly Pipeline Review (5 minutes)

Help me review my pipeline. Here are my open deals:

[Paste your pipeline data or describe your deals]

For each deal, tell me:
1. Risk level (green/yellow/red) and why
2. One specific next action I should take this week
3. If I should escalate, change strategy, or let it ride

Be direct. Don't sugarcoat.

🎯 Account Mapping (10 minutes)

I'm building an account plan for [COMPANY].

What I know so far: [paste any notes]

Help me:
1. Identify the likely buying committee (titles and roles)
2. Map potential champions vs. blockers
3. Find the economic buyer
4. Suggest a multi-thread strategy
5. Draft a personalized message for each key contact

📞 Objection Handling Prep

I sell [your product/service] to [your buyer persona].

The top 5 objections I hear are:
1. [objection]
2. [objection]
3. [objection]
4. [objection]
5. [objection]

For each one, give me:
- A 1-sentence reframe
- A follow-up question that uncovers the real concern
- A customer proof point I can reference (make it realistic)

📝 Post-Call CRM Summary

I just finished a call with [NAME] at [COMPANY].

Here's what happened: [brain dump your notes]

Turn this into:
1. A clean Salesforce/HubSpot activity note (professional, concise)
2. Key pain points identified
3. Agreed next steps with dates
4. A follow-up task description
5. Internal notes for my manager

⚔️ Competitive Battle Card

My prospect is also evaluating [COMPETITOR].

Research [COMPETITOR] and give me:
1. Their key strengths (be honest)
2. Their key weaknesses
3. Where we win head-to-head
4. Common objections when competing against them
5. Landmine questions I can ask that expose their weaknesses

---

---

🔴 Level 4 — For Builders

You want to make your own projects this accessible. Here's the standard.

---

The MRRS Standard

Everything you've seen on this page follows a pattern called MRRS (Machine-Readable Repo Standard). It's a set of templates that makes any GitHub project understandable by everyone.

Full standard + templates: github.com/MahoneyContextProtocol/mrrs

Make Your Own SKILL.md

A SKILL.md file turns any project into something AI tools can instantly understand. The format works with: ChatGPT, Claude, Perplexity, Gemini, Cursor, Windsurf, Blackbox AI, Cline, Aider, Continue.dev, OpenCode, Mistral, and any MCP-compatible client.

Design Principles

graph TD
    P1["🎨 Visual First<br/><i>Diagrams before text</i>"] --> P2["📖 Levels, Not Walls<br/><i>Start simple, go deep</i>"]
    P2 --> P3["🚪 Every Path Leads Somewhere<br/><i>Non-tech, dev, AI — all welcome</i>"]
    P3 --> P4["🤖 AI-Native<br/><i>SKILL.md + MANIFEST.yml<br/>for instant machine parsing</i>"]
    P4 --> P5["🔗 Tool-Connected<br/><i>Workflows link to<br/>real tools people use daily</i>"]

    style P1 fill:#fd79a8,color:#fff,stroke:none
    style P2 fill:#a29bfe,color:#fff,stroke:none
    style P3 fill:#00b894,color:#fff,stroke:none
    style P4 fill:#0984e3,color:#fff,stroke:none
    style P5 fill:#6c5ce7,color:#fff,stroke:none

Loading

Apply MRRS to Your Project

git clone https://github.com/MahoneyContextProtocol/mrrs.git /tmp/mrrs
cp -r /tmp/mrrs/template/* your-project/
cp -r /tmp/mrrs/template/.github your-project/
# Fill in {placeholders}, commit, push

Or point any AI coding assistant at the MRRS SKILL.md and say: "Apply MRRS to this repo."

---

💡 Quick Reference Card

graph TD
    subgraph "🔍 FIND"
        F1["Search GitHub for<br/>a tool you need"]
    end

    subgraph "📋 GRAB"
        G1["Find SKILL.md<br/>or README"]
    end

    subgraph "🤖 CREATE"
        C1["Make a Custom GPT<br/>or Claude Project<br/>or Perplexity Space"]
    end

    subgraph "📎 TEACH"
        T1["Upload SKILL.md<br/>to your AI assistant"]
    end

    subgraph "💬 USE"
        U1["Chat with your<br/>assistant daily"]
    end

    subgraph "🔗 CONNECT"
        X1["Link to Salesforce,<br/>HubSpot, Clay, etc."]
    end

    F1 --> G1 --> C1 --> T1 --> U1 --> X1

    style F1 fill:#a29bfe,color:#fff,stroke:none
    style G1 fill:#6c5ce7,color:#fff,stroke:none
    style C1 fill:#fd79a8,color:#fff,stroke:none
    style T1 fill:#e17055,color:#fff,stroke:none
    style U1 fill:#00b894,color:#fff,stroke:none
    style X1 fill:#0984e3,color:#fff,stroke:none

Loading

---

📜 License

MIT — Free to use, modify, and share.

---

Created by Joe Mahoney at Cloud Latitude

⭐ Star this repo if it made GitHub less scary.
🔗 Share it with someone who thinks GitHub isn't for them.