Skip to content

fly ai agent skill

feat: add error handling guidance to SKILL.md

Darkingtail0acfb5d947c0
diff --git a/skills/flyai/SKILL.md b/skills/flyai/SKILL.md
index 1680cb0..0d32aea 100644
--- a/skills/flyai/SKILL.md
+++ b/skills/flyai/SKILL.md
@@ -86,6 +86,30 @@ flyai config set FLYAI_API_KEY "your-key"
- **Marriott hotel search** (`search-marriott-hotel`): structuring Marriott Group's hotel results for deep comparison.
- **Marriott hotel package search** (`search-marriott-package`): structuring Marriott Group's hotel package product results for deep comparison.
+## Error Handling
+
+1. **Validate** — before running a command, check that the inputs are reasonable.
+ - Dates should not be in the past.
+ - Ambiguous or vague parameters (e.g. city names) should be
+ confirmed with the user before searching.
+ - Do not guess missing required parameters — ask the user.
+2. **Diagnose** — when a command fails or returns unexpected results,
+ check the output for error messages or status codes.
+ - Parameter error → re-read the corresponding `references/` doc,
+ fix the parameters, and retry.
+ - Service or network error → retry the command.
+ - Quota or permission error → inform the user and guide them
+ to resolve the access issue.
+3. **Adapt** — if the command succeeds but results are empty or insufficient:
+ - Broaden the search: relax filters, or try `keyword-search` / `ai-search`
+ with the user's original intent as a natural language query.
+ - If no alternative yields results, inform the user
+ and suggest adjusting search criteria.
+4. **Be transparent** — when results appear incomplete or inconsistent
+ with user expectations, present available results and let the user know
+ that results may vary. Suggest verifying through other channels
+ if accuracy is critical.
+
## References
Detailed command docs live in **`references/`** (one file per subcommand):