channels-read

Read channel messages with filters and return chronological metadata.

3|Updated Nov 16, 2025
One-click install
npx skills add https://github.com/tnez/dot-agents --skill channels-read
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: channels-read
Source: https://github.com/tnez/dot-agents/tree/main/skills/channels/read
Command: npx skills add https://github.com/tnez/dot-agents --skill channels-read

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires dot-agents, and includes scripts (resource) components.

What problem does it solve?

This Skill helps you stay informed about agent activity by quickly pulling messages from channels. It reduces time spent scanning multiple conversations and helps you catch important updates, decisions, and blockers.

Core Features & Use Cases

  • Read latest messages from a channel to review status and progress
  • Apply filters with --limit and --since to focus on what matters
  • Review DMs and direct messages to stay in the loop
  • Use Case: You need a quick snapshot of #status to decide next steps without scrolling through the entire history

Quick Start

Bash: bash scripts/read.sh "#status" --limit 5

Frequently Asked Questions about channels-read

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I read messages from a channel to catch up on updates?

Read channel messages using the read operation by specifying the channel name. The Skill retrieves messages in chronological order with metadata including sender, timestamp, content, and reply count, helping you quickly review status updates and decisions without manual scrolling.

Can I filter channel messages by date or limit the number of results?

Yes, apply filters using --since to retrieve messages from a specific date and --limit to cap the number of results returned. These flags let you focus on recent activity or a defined time window without processing entire message history.

Does this Skill work with direct messages and custom channels?

The Skill retrieves messages from public channels, direct messages, and custom channels. You specify the target channel by name and the operation applies uniformly, making it suitable for monitoring status channels, DMs, and project-specific conversations.

How do I automate staying informed about agent activity across channels?

Use the CLI with dot-agents automation to trigger channel reads on schedule or in response to events. This reduces manual checking and ensures you catch important blockers, decisions, and progress updates across multiple conversations automatically.

What metadata is included when I read messages from a channel?

Each message returned includes Message ID, Timestamp, Sender, Content, and Reply count. This metadata enables you to prioritize high-engagement discussions, identify conversation threads, and track message timing for context and decision-making.

Can I use tags to filter messages within a channel read?

Yes, the Skill supports --tags as an optional filter to narrow results. This allows you to isolate specific categories or labels within a channel, streamlining your review of relevant issues or session logs.