yaas-quest-creation

Scaffold a new quest folder with watch definitions under state/quests/active/.

4|1|Updated Jul 22, 2026
One-click install
npx skills add https://github.com/circlefin/sidequestor --skill yaas-quest-creation-circlefin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: yaas-quest-creation
Source: https://github.com/circlefin/sidequestor/tree/main/src/sidequestor/runtime/yaas-triage/skills/yaas-quest-creation
Command: npx skills add https://github.com/circlefin/sidequestor --skill yaas-quest-creation-circlefin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Setting up ongoing monitoring of Slack threads, DMs, schedules, email, Jira, GitHub, Telegram, or X activity requires creating a correctly structured quest folder with four files (meta.json, watch.json, timeline.ndjson, context.md). Hand-writing these files causes schema errors like wrong IDs or missing fields; this Skill scaffolds them correctly through a validated script. ## Core Features & Use Cases - Interactive quest scaffolding: Gathers title, watch targets, priority, and context from the user, then creates the quest via the sq new-quest script with full validation. - Multi-source watch types: Supports slack_thread, slack_channel, slack_dm, slack_mention, schedule (cron or one-shot), email, jira, github_pr, github_issue, telegram, and x watches with per-type required fields. - Pre-dispatch filters: Configures filter_user_ids and filter_keywords on Slack watches so irrelevant messages never wake the worker. - Use Case: A user pastes a Slack permalink and says "track this thread for the partner's reply." The Skill extracts channel_id and thread_ts, confirms details, and creates a quest that the triage loop picks up on its next tick. ## Quick Start Ask the assistant to create a quest that watches a specific Slack thread or channel, providing the permalink and a short description of what to track.

Frequently Asked Questions about yaas-quest-creation

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

FAQPage Schema
How do I create a quest to track a Slack thread?▼

Provide the Slack permalink and a short title; the Skill extracts channel_id and thread_ts from the URL, confirms details with you, then runs sq new-quest with a slack_thread watch. The triage loop picks the quest up on its next tick.

What watch types can a quest monitor?▼

Quests support slack_thread, slack_channel, slack_dm, slack_mention, schedule (cron or one-shot), email, jira, github_pr, github_issue, telegram_chat, telegram_search, and several X watch types. Each type has required fields validated by the new-quest script against checker manifests.

How do I extract channel_id and thread_ts from a Slack permalink?▼

The channel_id is the segment after /archives/ in the URL, and thread_ts is the thread_ts query parameter, or the p... path segment converted to <10digits>.<6digits> format. Always watch the parent thread_ts, not a reply's timestamp.

Can I filter which messages wake the worker in a watched channel?▼

Yes, slack_channel and slack_thread watches accept filter_user_ids and filter_keywords, evaluated inside the checker scripts before any dispatch. Both set together are AND-ed, so non-matching messages never wake the worker.

Why does the quest creation script reject my watch entry?▼

The script rejects entries missing a type or reason, entries with unknown types lacking a checkers/<type>.py file, entries that include last_checked_ts, and Slack IDs in the wrong namespace such as a user ID in a channel field.

When should I not create a quest?▼

Do not create a quest for one-off questions answerable in the current session or tasks needing no follow-up. Also avoid it for updating existing quests, which should use the locking helpers from the quest dispatch workflow instead.