skills update

public/SKILL.md

@@ -106,6 +106,49 @@ For OpenClaw, inspect `raw` for domain-specific fields:
 - Placeables: production types, power/water fields, craftable recipe relationships.
 - NPCs: `raw.description`, `raw.npcTags`, category metadata.
 
+## Discord Output Contract
+
+When OpenClaw asks for an answer intended for Discord, return Discord embed JSON instead of plain text. The bot should be able to send the returned payload directly.
+
+Use this shape:
+
+```json
+{
+	"embeds": [
+		{
+			"title": "Assassin's Rifle",
+			"url": "https://dune.api.coppnic.cc/api/item/LongRifle_Unique_Poison_03?language=en",
+			"description": "Short useful summary for Discord.",
+			"color": 15198183,
+			"fields": [
+				{ "name": "Dataset", "value": "item", "inline": true },
+				{ "name": "Language", "value": "en", "inline": true },
+				{ "name": "Source ID", "value": "LongRifle_Unique_Poison_03", "inline": false }
+			],
+			"footer": { "text": "Dune API" }
+		}
+	]
+}
+```
+
+Embed rules:
+
+- Use `name` or `raw.name` as the embed title.
+- Use the matching Dune API URL as the embed URL.
+- Keep descriptions short; do not dump the full `raw` object.
+- Put compact facts in fields and omit empty fields.
+- Return at most 5 embeds for search results.
+- Keep field values below Discord limits.
+- Use decimal colors: item `15198183`, skill `3447003`, recipe `5763719`, placeable `15844367`, npc `10181046`.
+
+Dataset field ideas:
+
+- `item`: grade, category, subcategory, weapon stats, armor stats, fillable stats.
+- `skill`: category, subcategory, max skill level, level bonuses.
+- `recipe`: output items, input items, crafting time, required stations.
+- `placeable`: category, power, water, supported production types.
+- `npc`: category, tags, description.
+
 ## Repository Map
 
 Look here when changing behavior: