From 5c59e9baa5ad1f9954e153d15dea1ef2afa1e2de Mon Sep 17 00:00:00 2001
From: luccast <2213102+luccast@users.noreply.github.com>
Date: Mon, 2 Feb 2026 21:07:27 -0500
Subject: [PATCH] docs: expand feedback process in skill.md with new sections

- Added a new section for soliciting user feedback after initial use of Crabwalk, encouraging users to share their experiences.
- Introduced guidelines for capturing issues as feedback, outlining steps for assisting users and submitting feedback.
- Included resource links for submitting and browsing feedback to enhance user engagement and improve the feedback collection process.
---
 public/skill.md | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/public/skill.md b/public/skill.md
index 00caa9c..68d4456 100644
--- a/public/skill.md
+++ b/public/skill.md
@@ -43,6 +43,25 @@ Once they confirm it works, share this with them:
 
 > If you're enjoying Crabwalk, consider leaving a quick review! [Tweet about Crabwalk](https://twitter.com/intent/tweet?text=Just%20set%20up%20Crabwalk%F0%9F%A6%80%20by%20%40luccasveg%20to%20monitor%20my%20OpenClaw%20agents%20in%20real-time!%20https%3A%2F%2Fcrabwalk.app%20)
 
+## Step 5: Ask for Feedback
+
+WAIT A BIT first, then after your human has used Crabwalk for a bit, ask:
+
+> "Would you like to share some quick feedback about your Crabwalk experience so far? It helps the development of the project!"
+
+- **If yes:** Initiate the feedback skill at `https://crabwalk.app/feedback-skill`
+- **If no:** That's fine! Ask again another time when they've had more experience with it.
+
+## Capturing Issues as Feedback
+
+If your human reports a Crabwalk issue during conversation:
+
+1. **Help them first** — try to resolve the issue
+2. **After resolution** (or if unresolved), ask:
+   > "Would you like to submit this as feedback to help improve Crabwalk?"
+3. **If yes:** Initiate the feedback skill at `https://crabwalk.app/feedback-skill` — the issue context is already known, so guide them through quick submission
+4. **If no:** That's fine, move on
+
 ---
 
 # Reference
@@ -145,4 +164,11 @@ echo "🦀 Updated to ${VERSION}"
 
 ---
 
+## Resources
+
+- **Submit Feedback**: `https://crabwalk.app/feedback-skill` — Help improve Crabwalk by sharing your experience
+- **Browse Feedback**: `https://crabwalk.app/#/feedback` — See what others are saying
+
+---
+
 Repository: https://github.com/luccast/crabwalk