ariffazil/agent-dialogue-explanation
hermes-skills/communication/agent-dialogue-explanation/SKILL.md
Write two-agent dialogues to explain technical protocols (A2A, MCP, etc.) to non-technical humans. Uses character contrast (senior/junior agent) and Malay-English mix for Malaysian audience.
tools
Updated May 12, 2026
$ install --global
skillsauthnpx skillsauth add ariffazil/openclaw-workspace agent-dialogue-explanationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 12, 2026, 3:29 AM160.7s1 file scanned
SKILL.md
- name:
- agent-dialogue-explanation
- description:
- Write two-agent dialogues to explain technical protocols (A2A, MCP, etc.) to non-technical humans. Uses character contrast (senior/junior agent) and Malay-English mix for Malaysian audience.
- triggers:
- ["explain A2A to human", "teach protocol via dialogue", "multi-agent explanation format"]
- tags:
- [communication, explanation, A2A, MCP, arifOS]
Agent Dialogue Explanation Skill
When to Use
- User asks to explain a technical protocol (A2A, MCP, etc.) in human language
- Target audience has zero coding knowledge
- Goal is comprehension, not operational procedure
Format: Two-Agent Dialogue
Characters:
- Senior agent (AGI_bot type) — experienced, patient, mixes Malay and English naturally
- Junior agent (ASI_bot type) — asks "obvious" questions a human would ask, curious but not stupid
- Human (Arif) — observes, asks the "obvious" follow-ups
Structural Template
SCENE: setting
PART 1: The obvious question
→ Why do we even need this? (asked by junior)
→ The simple analogy (given by senior)
PART 2: Core concept — name card / discovery
→ How do agents find each other?
PART 3: Core concept — sending work / delegation
→ How does one agent give work to another?
→ Streaming vs non-streaming (food delivery analogy)
PART 4: The structured result
→ It's not text, it's formal data
→ JSON-RPC explained via contrast (formal report vs "eh almost done la")
PART 5: Comparison (A2A vs MCP)
→ Most important distinction
→ One-sentence framing per protocol
PART 6: Real flow walkthrough
→ Step-by-step in arifOS context
→ Human perspective = seamless
PART 7: Skills and policies
→ On-demand vs hold (ask permission)
→ Real-world framing
SUMMARY: One paragraph for Arif to take away
Key Principles
- Analogy first, technical term second — always lead with the human relatable comparison
- Malay-English mix — match the user's own communication style (Arif uses: "kan", "betul", "sini", "kena", "macam")
- The junior agent is the human's voice — when junior asks "why WhatsApp isn't enough", that's what Arif would ask
- Never mention implementation details unless asked
- Save as docs/PROTOCOL_DIALOGUE.md in the relevant project repo
Example Output Location
/root/arifOS/docs/A2A_DIALOGUE.md — saved as canonical reference
Related Skills
ariffazil/openclaw
testing
VerifiedTrustedCommunity
OpenClaw edge agent bridge — operational triage, doctor, restart, and A2A bridge routing for the federation edge (Telegram surface). USE WHEN: "openclaw unhealthy", "gateway down", "edge bot not responding", "a2a bridge disconnected", "watchdog tripped", "openclaw doctor", "openclaw restart". NOT for token/security audit — use FORGE-telegram-audit.
2SKILL.mdUpdated Aug 8, 2026
ariffazil/MiniMax Image Generation
tools
VerifiedTrustedCommunity
Generate images, videos, TTS, voice clone, and music via MiniMax MCP server. Use when user asks to "draw", "generate image", "create picture", "make a photo", "text to image", "image generation".
2SKILL.mdUpdated Aug 8, 2026
ariffazil/arifos-constitutional-judge
testing
VerifiedTrustedCommunity
Single load-bearing constitutional-judgment skill. Routes all F1–F13, verdict, hold, seal, scope, authority and floor-check calls through the live arif_judge surface. Replaces 7 overlapping predecessors (arifos-constitutional-judge, arifos-constitutional-judge, arifos-constitutional-judge, arifos-constitutional-judge, arifos-constitutional-judge, arifos-constitutional-judge, arifos-constitutional-judge).
2SKILL.mdUpdated Aug 8, 2026
ariffazil/FORGE-lsp-pre-edit-gate
development
VerifiedTrustedCommunity
MANDATORY LSP grounding gate BEFORE any code mutation on .ts, .py, .js, .tsx, .jsx files. Forces the agent to read real-time compiler diagnostics and structural project context before editing — eliminating blind guesses and anchoring every mutation in F2 (TRUTH). Routes through arifOS kernel (:8088) for centralized gate logic.
2SKILL.mdUpdated Aug 8, 2026