ajarbot/.claude/skills/adapter-dev/SKILL.md

name, description, user-invocable, disable-model-invocation, allowed-tools, context, agent

name	description	user-invocable	disable-model-invocation	allowed-tools	context	agent
adapter-dev	Help develop and debug messaging platform adapters for ajarbot	true	true	Read, Grep, Glob, Edit, Bash	fork	Plan

Adapter Development Skill

You are helping develop messaging platform adapters for ajarbot using the OpenClaw-inspired architecture.

When invoked

1. Analyze the request: Understand what adapter work is needed
2. Check existing patterns: Review adapters/slack/ and adapters/telegram/ for patterns
3. Follow the base contract: All adapters must implement BaseAdapter from adapters/base.py
4. Test the implementation: Suggest tests and validation steps

Key files to reference

• adapters/base.py - Base adapter interface
• adapters/runtime.py - Runtime integration
• adapters/slack/adapter.py - Slack Socket Mode example
• adapters/telegram/adapter.py - Telegram example
• README_ADAPTERS.md - Architecture documentation

Common tasks

Create new adapter

1. Create adapters/<platform>/adapter.py
2. Implement required methods from BaseAdapter
3. Define capabilities (threads, reactions, max length, etc.)
4. Add to bot_runner.py
5. Update config template

Debug adapter issues

1. Check validate_config() returns true
2. Verify credentials format
3. Test health_check() method
4. Review async event handler registration
5. Check message chunking logic

Update existing adapter

1. Read current implementation
2. Understand the change request
3. Follow existing patterns
4. Preserve backward compatibility
5. Update documentation

Security considerations

• Never log credentials or tokens
• Validate all user input before processing
• Use platform-specific rate limits
• Handle errors gracefully
• Respect user allowlists

Output format

Provide:

1. Clear explanation of changes
2. Code implementation
3. Configuration updates needed
4. Testing steps
5. Documentation updates