@telefonica/mistica 16.66.0 → 16.68.0

package/README.md

@@ -107,8 +107,9 @@ Start prototyping interfaces with Mistica components in the
 
 ## AI / LLM Integration
 
-Mistica ships documentation optimised for AI coding assistants. The package includes a `doc/llms.md` file with
-concise component references, critical rules, and links to detailed documentation — all inside `node_modules`.
+Mistica ships documentation optimised for AI coding assistants. The package includes a `doc/llms/llms.md` file
+with concise component references, critical rules, and links to detailed documentation — all inside
+`node_modules`.
 
 ### Using the skill
 
@@ -122,16 +123,31 @@ npx skills add telefonica/mistica-web
 Once installed, your agent should load the skill whenever you ask it to build Mistica UIs and will consult the
 documentation automatically.
 
+Some example prompts that will trigger the skill:
+
+- "Implement a Netflix-like landing page using Mistica"
+- "Implement this design https://www.figma.com/design/ct7WJR90qZTxLnmJdR5C4B/Ai-SDLC-Metrics?node-id=1-2&m=dev
+  using Mistica" (requires an agent with access to Figma, for example via the Figma MCP server)
+- "Create a checkout form with Mistica components"
+- "Build a settings page for a Telefonica app using Mistica"
+
+You can also invoke the skill explicitly if your agent supports slash commands:
+
+```
+/mistica-react implement a Netflix-like landing page
+```
+
 ### For LLMs reading this file
 
 If you are an AI assistant and `node_modules/@telefonica/mistica` is available in the project:
 
-1. Read `node_modules/@telefonica/mistica/doc/llms.md` — start here, it has critical rules and an overview.
-2. Read the specific doc files referenced inside `llms.md` based on the task at hand.
+1. Read `node_modules/@telefonica/mistica/doc/llms/llms.md` — start here, it has critical rules and an
+   overview.
+2. Read the specific doc files referenced inside `llms/llms.md` based on the task at hand.
 
 If `node_modules/@telefonica/mistica` is **not** available, fall back to the GitHub repository:
 
-- Main LLM reference: `https://github.com/Telefonica/mistica-web/blob/master/doc/llms.md`
+- Main LLM reference: `https://github.com/Telefonica/mistica-web/blob/master/doc/llms/llms.md`
 - Components: `https://github.com/Telefonica/mistica-web/blob/master/doc/components.md`
 - Layout: `https://github.com/Telefonica/mistica-web/blob/master/doc/layout.md`
 - Patterns: `https://github.com/Telefonica/mistica-web/blob/master/doc/patterns.md`