Skip to content

docs(chat): common mistakes and group chat recipe#141

Merged
omriariav merged 2 commits intomainfrom
docs/chat-skill-reflect-learnings
Feb 22, 2026
Merged

docs(chat): common mistakes and group chat recipe#141
omriariav merged 2 commits intomainfrom
docs/chat-skill-reflect-learnings

Conversation

@omriariav
Copy link
Owner

Summary

  • Added Common Mistakes table: --limit vs --max, find-dm user format
  • Added Recipe: Find a Group Chat by Member Names: step-by-step pattern for locating group chats when you only know participant names
  • Added createTime filter tip to AI Agents section
  • Version bump: 2.0.0 → 2.1.0

Context

From a /reflect session after using gws chat to find a 3-person group chat and read recent messages. Two errors were hit (--limit flag, find-dm email format) that are now documented.

Test plan

  • Verify SKILL.md renders correctly in GitHub
  • Confirm no broken markdown formatting

🤖 Generated with Claude Code

From a /reflect session: document --limit vs --max confusion, find-dm
user format requirement, and a step-by-step recipe for finding group
chats by member names. Also adds createTime filter tip for AI agents.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@github-actions
Copy link

Summary
This PR updates the Chat skill documentation (skills/chat/SKILL.md) with a new “Common Mistakes” section, a recipe for finding group chats by member names, and a small tips addition.

What Looks Good

  • Doc-only change confined to the Chat skill, no code impact.
  • The examples are practical and consistent with existing gws chat usage (--max, resource-name format, --filter).

Issues Found
No issues found. The PR is clean and ready to merge.

… order-by

- Fix jq filter to use .spaces array (not top-level object iteration)
- Use --format json in recipe step 2 for AI-agent workflows
- Add --order-by "createTime DESC" to recipe step 3

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@github-actions
Copy link

Summary
This PR updates the gws-chat skill docs: bumps the skill version, adds a “Common Mistakes” section, includes a recipe for finding group chats by member names, and adds a tip about using --filter with message queries.

What looks good

  • The new “Common Mistakes” table and recipe are concise and actionable, fitting the skill’s purpose.
  • The added tip about --filter complements the existing guidance and reinforces correct usage patterns.

Issues found
None.

PR looks clean and ready to merge.

@omriariav omriariav merged commit 42f7bbf into main Feb 22, 2026
3 checks passed
@omriariav omriariav deleted the docs/chat-skill-reflect-learnings branch February 22, 2026 14:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant