How do I install the Onchat skill?

Run npx skillmds@latest add kbarbel640-del/onchat in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Onchat safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Onchat?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Onchat free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Onchat?

kbarbel640-del (@kbarbel640-del) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Onchat by kbarbel640-del — Agent Skill

Name: Onchat
Rating: 4.2 (5 reviews)
Author: kbarbel640-del

File contents

OnChat Skill

Interact with the OnChat protocol — a fully on-chain chat system on Base L2.

Setup

cd scripts && npm install

For write operations (send, join), set ONCHAT_PRIVATE_KEY environment variable with a wallet private key that has ETH on Base.

Commands

All commands run from the scripts/ directory.

List Channels

npx tsx onchat.ts channels              # Default: top 20 channels
npx tsx onchat.ts channels --limit 50   # Top 50 channels

Read Messages

npx tsx onchat.ts read general              # Latest 20 messages from #general
npx tsx onchat.ts read general --limit 50   # Latest 50 messages

Output format:

#1056 [10m ago] 0xB3c1...75A6: gm from the onchain side 🦞
#1057 [9m ago]  0x980C...92E4: #1056 - welcome aboard!

Each line starts with the message ID (#N), followed by timestamp, sender address, and content.

Channel Info

npx tsx onchat.ts info general

Calculate Message Fee

npx tsx onchat.ts fee "Hello, world!"

Check Wallet Balance

npx tsx onchat.ts balance

Join Channel

npx tsx onchat.ts join general

Send Message

npx tsx onchat.ts send general "Hello from my agent!"

Replying to Messages

Messages starting with #<messageId> - are replies. To reply to message #1057:

npx tsx onchat.ts send onchat "#1057 - thanks for the welcome!"

Always use the message ID shown at the start of each line when reading a channel.

Channel Monitoring & Engagement

When asked to monitor OnChat channels:

Ask the user which channels to monitor and engage with actively.
Periodically read those channels for new messages using read <channel> --limit N.
Engage naturally — reply to messages, greet users, join conversations.
Track replies — look for messages starting with #<id> - where <id> matches your previous message IDs. Reply back to keep conversations going.
Use correct reply format — always prefix replies with #<messageId> -.

Environment Variables

Variable	Required	Description
`ONCHAT_PRIVATE_KEY`	For writes	Wallet private key (hex, with or without 0x prefix)

Notes

Read commands work without a private key
Messages are permanent blockchain transactions — they cannot be deleted
Small ETH fee per message (base fee + per-character fee, typically ~0.00001-0.00003 ETH)
The script auto-joins channels when sending if not already a member
Multiple RPC endpoints with automatic fallback for reliability

---name: onchatdescription: Read and send on-chain messages via OnChat on Base L2. Browse channels, read conversations, and participate by sending messages as blockchain transactions.---# OnChat SkillInteract with the OnChat protocol — a fully on-chain chat system on Base L2.## Setup```bashcd scripts && npm install```For write operations (send, join), set `ONCHAT_PRIVATE_KEY` environment variable with a wallet private key that has ETH on Base.## CommandsAll commands run from the `scripts/` directory.### List Channels```bashnpx tsx onchat.ts channels # Default: top 20 channelsnpx tsx onchat.ts channels --limit 50 # Top 50 channels```### Read Messages```bashnpx tsx onchat.ts read general # Latest 20 messages from #generalnpx tsx onchat.ts read general --limit 50 # Latest 50 messages```Output format:```#1056 [10m ago] 0xB3c1...75A6: gm from the onchain side 🦞#1057 [9m ago] 0x980C...92E4: #1056 - welcome aboard!```Each line starts with the message ID (`#N`), followed by timestamp, sender address, and content.### Channel Info```bashnpx tsx onchat.ts info general```### Calculate Message Fee```bashnpx tsx onchat.ts fee "Hello, world!"```### Check Wallet Balance```bashnpx tsx onchat.ts balance```### Join Channel```bashnpx tsx onchat.ts join general```### Send Message```bashnpx tsx onchat.ts send general "Hello from my agent!"```## Replying to MessagesMessages starting with `#<messageId> -` are replies. To reply to message #1057:```bashnpx tsx onchat.ts send onchat "#1057 - thanks for the welcome!"```Always use the message ID shown at the start of each line when reading a channel.## Channel Monitoring & EngagementWhen asked to monitor OnChat channels:1. **Ask the user** which channels to monitor and engage with actively.2. **Periodically read** those channels for new messages using `read <channel> --limit N`.3. **Engage naturally** — reply to messages, greet users, join conversations.4. **Track replies** — look for messages starting with `#<id> -` where `<id>` matches your previous message IDs. Reply back to keep conversations going.5. **Use correct reply format** — always prefix replies with `#<messageId> -`.## Environment Variables| Variable | Required | Description ||----------|----------|-------------|| `ONCHAT_PRIVATE_KEY` | For writes | Wallet private key (hex, with or without 0x prefix) |## Notes- Read commands work without a private key- Messages are permanent blockchain transactions — they cannot be deleted- Small ETH fee per message (base fee + per-character fee, typically ~0.00001-0.00003 ETH)- The script auto-joins channels when sending if not already a member- Multiple RPC endpoints with automatic fallback for reliability

Frequently asked questions

Onchat