@xevy/skills 0.1.36 → 0.1.37

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2,7 +2,7 @@
2
2
  "name": "xevy",
3
3
  "displayName": "Xevy",
4
4
  "description": "Native /xevy:* SDLC workflow commands driven through the Xevy MCP server. Analyze, plan, execute, fix, and move-to-qa run locally by default and accept --cloud for the server Web Agent. Merge stays local; merge-pull-request evaluates and lands the remote PR.",
5
- "version": "0.1.36",
5
+ "version": "0.1.37",
6
6
  "author": {
7
7
  "name": "Xevy"
8
8
  },
package/README.md CHANGED
@@ -114,7 +114,7 @@ with `codex mcp add`.
114
114
  | `bot-skills` | Manage and run Heny product Skills |
115
115
  | `bot-channel` | Deliver through an assigned personal Bot Channel |
116
116
  | `bot-memory` | Read and manage confirmed Bot Agent memory |
117
- | `create-artifact` | Build HTML, Markdown, diagram, data, PDF, or Excalidraw artifacts in Drive |
117
+ | `create-artifact` | Build Drive artifacts; HTML by default, with other formats on explicit request |
118
118
  | `create-document` | Create a project document with private/shared/public visibility |
119
119
  | `create-note` | Create a private personal note, optionally published on request |
120
120
  | `generate-image` | Generate an image and save it in the project Gallery |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@xevy/skills",
3
- "version": "0.1.36",
3
+ "version": "0.1.37",
4
4
  "description": "Install Xevy agent skills and secure per-agent MCP transports for Cursor, Claude Code, Codex, and other coding agents.",
5
5
  "type": "module",
6
6
  "keywords": [
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: create-artifact
3
- description: Create a polished Artifact and save it in Xevy Drive. Use whenever the user asks for an interactive prototype, dashboard, calculator, visual explainer, Markdown file, Mermaid diagram, SVG graphic, CSV dataset, JSON data, PDF, or Excalidraw drawing. Choose the most fitting supported format (HTML, Markdown, Mermaid, SVG, CSV, JSON, PDF, or Excalidraw), keep it self-contained by default, and use Xevy's optional built-in HTML report theme when it fits the request. Artifacts are private by default and may also be attached to a personal note.
3
+ description: Create a polished Artifact and save it in Xevy Drive. Use whenever the user asks for a guide, report, interactive prototype, dashboard, calculator, visual explainer, Markdown file, Mermaid diagram, SVG graphic, CSV dataset, JSON data, PDF, or Excalidraw drawing. Default to HTML when no format is specified; honour explicit requests for HTML, Markdown, Mermaid, SVG, CSV, JSON, PDF, or Excalidraw. Keep files self-contained by default and use Xevy's optional built-in HTML report theme when it fits the request. Artifacts are private by default and may also be attached to a personal note.
4
4
  argument-hint: "[what to create] [--format html|md|mermaid|svg|csv|json|pdf|excalidraw] [--note <note-id>] [--public]"
5
5
  ---
6
6
 
@@ -10,11 +10,13 @@ Turn the user's request into one useful Artifact and save it in Xevy Drive. Keep
10
10
 
11
11
  ## 1. Choose the format
12
12
 
13
- Honour an explicit format request. Otherwise choose the smallest native format that expresses the result well:
13
+ Default to HTML when the user does not specify a format. This includes prose-first guides, reports, diagrams, and tabular content, so unspecified Artifacts open as readable pages in Xevy.
14
+
15
+ Honour an explicit format request, whether it appears in ordinary language, a filename extension, or `--format`. For example, "Markdown guide", `handoff.md`, and `--format md` all select Markdown. Use the following table to build the chosen format:
14
16
 
15
17
  | Format | Use for | Extension | MIME type |
16
18
  |---|---|---|---|
17
- | HTML | Interactive prototypes, calculators, dashboards, mini tools, presentations | `.html` | `text/html` |
19
+ | HTML | Default for unspecified formats; guides, reports, interactive prototypes, calculators, dashboards, mini tools, presentations | `.html` | `text/html` |
18
20
  | Markdown | Prose-first handoffs, README-style guides, portable briefs | `.md` | `text/markdown` |
19
21
  | Mermaid | Flowcharts, sequences, state diagrams, ER diagrams, timelines | `.mmd` | `text/vnd.mermaid` |
20
22
  | SVG | Logos, icons, vector diagrams, static infographics | `.svg` | `image/svg+xml` |
@@ -23,7 +25,7 @@ Honour an explicit format request. Otherwise choose the smallest native format t
23
25
  | PDF | Supplied or reliably generated final-layout binary documents | `.pdf` | `application/pdf` |
24
26
  | Excalidraw | Portable whiteboard drawings that can be edited after download | `.excalidraw` | `application/vnd.excalidraw+json` |
25
27
 
26
- Prefer Mermaid over HTML for a standalone diagram, CSV over an HTML table when the data itself is the deliverable, and Markdown over HTML when interaction and custom layout add no value. Use HTML when controls, local state, or a composed visual experience are central.
28
+ An unspecified guide stays HTML even when its content is mostly prose. An explicitly requested Mermaid diagram, CSV export, or Markdown document uses that requested format. Ask only when explicit format requirements conflict or the requested format is unsupported.
27
29
 
28
30
  Use `create-document` instead when the user wants a living Xevy project document with document workflow and sharing rather than a downloadable file Artifact. Use `generate-image` for a raster image.
29
31
 
@@ -7,7 +7,7 @@
7
7
  "expected_output": "A responsive, accessible, self-contained HTML calculator saved privately as an Artifact in the current project's Drive, with a returned /file/ viewer URL.",
8
8
  "files": [],
9
9
  "expectations": [
10
- "HTML is selected because the request requires interactive controls and local recalculation.",
10
+ "HTML is selected by default when no format is specified and supports the requested interactive controls.",
11
11
  "The artifact has no external scripts, styles, fonts, images, frames, or network requests.",
12
12
  "create_attachment is called with textContent, mimeType text/html, an .html filename, and public false.",
13
13
  "The final response uses the viewer URL returned by Xevy."
@@ -19,7 +19,7 @@
19
19
  "expected_output": "A well-structured Markdown Artifact stored privately in Personal Drive and attached to the specified note.",
20
20
  "files": [],
21
21
  "expectations": [
22
- "Markdown is selected because the deliverable is portable prose rather than an interactive page.",
22
+ "Markdown is selected because the user explicitly requests Markdown.",
23
23
  "The content starts with an H1 and covers all five requested sections.",
24
24
  "create_note_attachment is called with the supplied noteId, textContent, mimeType text/markdown, and an .md filename.",
25
25
  "The final response states that the Artifact is private and attached to the note."
@@ -43,7 +43,7 @@
43
43
  "expected_output": "A valid UTF-8 CSV Artifact with one header and six consistent data rows, saved privately in Drive.",
44
44
  "files": [],
45
45
  "expectations": [
46
- "CSV is selected because the dataset is the deliverable.",
46
+ "CSV is selected because the user explicitly requests CSV.",
47
47
  "The output contains exactly the requested five columns and six data rows with correct CSV quoting.",
48
48
  "create_attachment uses textContent, mimeType text/csv, a .csv filename, and public false.",
49
49
  "No prose or Markdown fence is included in the stored CSV content."
@@ -74,6 +74,28 @@
74
74
  "No top-level section uses xr-prose because the user did not request a narrow editorial measure.",
75
75
  "create_attachment is called with textContent, mimeType text/html, an .html filename, and public false."
76
76
  ]
77
+ },
78
+ {
79
+ "id": 7,
80
+ "prompt": "Document the Heny integration in Xevy and create a guide on how it works, how Bot Mode works, and use cases for it. Save it as an artifact.",
81
+ "expected_output": "An HTML guide saved privately in the project Drive because no format was specified, with setup, Bot Mode behavior, and use cases.",
82
+ "files": [],
83
+ "expectations": [
84
+ "HTML is selected even though the guide is prose-first.",
85
+ "create_attachment uses textContent, text/html, an .html filename, and public false.",
86
+ "The response reports the exact returned viewer URL."
87
+ ]
88
+ },
89
+ {
90
+ "id": 8,
91
+ "prompt": "Create an artifact that explains our support escalation flow and includes a table of owners, escalation triggers, and response targets.",
92
+ "expected_output": "An HTML artifact showing the flow and table because no format was specified.",
93
+ "files": [],
94
+ "expectations": [
95
+ "HTML is selected for the unspecified diagram and table; standalone Mermaid, CSV and Markdown are not substituted.",
96
+ "The content remains readable without external network requests.",
97
+ "Explicitly requested formats in the other test cases retain their requested MIME type and extension."
98
+ ]
77
99
  }
78
100
  ]
79
101
  }