Agent skill · software engineering · steipete
discrawl
Discord archive: search, sync freshness, DMs, summaries, TUI, repo/release work.
Why this skill is useful
Provides specific commands and workflows for managing Discord archives that the AI wouldn't reliably generate on its own.
What it needs
Requires discrawl installed locally. About 1k tokens when loaded. Last updated 2026-08-07. 385,400 stars on the source repository.
What this skill does
Discrawl Use local Discord archives first. For recent/current questions, check discrawl status --json; use discrawl doctor for source/config readiness. Refresh only when stale, missing the requested scope, or explicitly requested. Use --full only for deliberate historical backfills. Do not interrupt another archive writer to resolve a busy/locked database. Resolve configured paths instead of assuming default macOS, XDG, or legacy locations. Read Bounded Slices DISCRAWLNOAUTOUPDATE=1 suppresses git-share updates during read smokes. discrawl sql is read-only by default and accepts SQL arguments or stdin. Use it for exact counts/joins when normal reads are too coarse; never use --unsafe --confirm without an explicitly requested and reviewed database mutation. Consult subcommand help for filters. Report absolute date spans, channel/DM names, counts, freshness, and source gaps. Source Boundaries Desktop wiretap reads local artifacts; it must not extract credentials, use user tokens, call Discord as the user, or write Discord application storage. Bot sync needs configured bot credentials; never infer availability. Desktop DMs are local-only, not part of the published Git snapshot. Git-share snapshots must exclude secrets and @me DM rows. For implementation work or a genuinely missing CLI feature, verify the checkout remote is openclaw/discrawl and follow its instructions. Do not assume a machine-specific historical checkout path. ClawSweeper Sandbox Use the sandbox reader only: This reader imports https://github.com/openclaw/discord-store.git into /root/clawsweeper-sandbox-workspace/.discrawl/discrawl.db with discord.tokensource = "none". The published Git snapshot is public-channel filtered; do not use /root/.discrawl/config.toml or the rich writer DB from sandboxed public Discord sessions.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills steipete/discrawl