@xevy/skills 0.1.29 → 0.1.30
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. Work runs locally by default; pass --cloud to use the server Web Agent. The coding agent reviews and corrects the result after every action.",
|
|
5
|
-
"version": "0.1.
|
|
5
|
+
"version": "0.1.30",
|
|
6
6
|
"author": {
|
|
7
7
|
"name": "Xevy"
|
|
8
8
|
},
|
package/README.md
CHANGED
|
@@ -104,7 +104,11 @@ with `codex mcp add`.
|
|
|
104
104
|
|
|
105
105
|
| Skill | Purpose |
|
|
106
106
|
|-------|---------|
|
|
107
|
-
| `
|
|
107
|
+
| `create-artifact` | Build a self-contained interactive HTML artifact and save it in Drive |
|
|
108
|
+
| `create-document` | Create a project document with private/shared/public visibility |
|
|
109
|
+
| `create-note` | Create a private personal note, optionally published on request |
|
|
110
|
+
| `generate-image` | Generate an image and save it in the project Gallery |
|
|
111
|
+
| `xevy-setup` | Link repo, `.xevy/project.json`, deploy defaults, env sync |
|
|
108
112
|
| `analyze [task] [--cloud]` | Task analysis (local by default) |
|
|
109
113
|
| `plan [task] [--cloud]` | Planning + review (local by default) |
|
|
110
114
|
| `execute [task] [--cloud]` | Build, verify, and open a PR (local by default) |
|
package/package.json
CHANGED
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: create-artifact
|
|
3
|
+
description: Create a self-contained interactive HTML artifact and save it in Xevy Drive. Use for interactive prototypes, dashboards, calculators, diagrams, visual explainers, mini tools, and polished HTML presentations. Artifacts are private by default and open in Xevy's sandboxed /file/ viewer. This initial version supports HTML only; use generate-image for static images and create-document for prose-first project documents.
|
|
4
|
+
argument-hint: "[what to build] [--note <note-id>] [--public]"
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Create an HTML artifact
|
|
8
|
+
|
|
9
|
+
Turn the user's request into one polished, self-contained HTML file and save it as an **Artifact** in Xevy Drive. HTML is the only artifact format supported by this skill for now.
|
|
10
|
+
|
|
11
|
+
## 1. Resolve where it belongs
|
|
12
|
+
|
|
13
|
+
- Read `.xevy/project.json` when available and use its `workspaceIdentifier` and `projectIdentifier`. Otherwise use the Xevy discovery tools available in the host, or ask for the project only when it cannot be inferred safely.
|
|
14
|
+
- If the user explicitly asks to attach the artifact to a personal note, obtain the note UUID from the request or current context and use `create_note_attachment`. That route stores the artifact in Personal Drive and inserts it into the note.
|
|
15
|
+
- Otherwise use `create_attachment` so the artifact appears in the selected project's Drive.
|
|
16
|
+
- If the request references a task code, resolve it with `find_task` and pass the returned UUID as `taskId` when creating the project artifact.
|
|
17
|
+
|
|
18
|
+
## 2. Build a self-contained HTML document
|
|
19
|
+
|
|
20
|
+
Return a complete document with `<!doctype html>`, `<html>`, `<head>`, viewport metadata, and `<body>`. Put all CSS and JavaScript inline because the sandbox deliberately blocks network access.
|
|
21
|
+
|
|
22
|
+
Design around the requested job rather than a generic template:
|
|
23
|
+
|
|
24
|
+
- Make the primary information or interaction immediately clear.
|
|
25
|
+
- Use semantic HTML, visible keyboard focus, labelled controls, sufficient contrast, and responsive layout.
|
|
26
|
+
- Keep interactions usable with keyboard and pointer. Honour `prefers-reduced-motion` when motion is present.
|
|
27
|
+
- Use system fonts, inline SVG, CSS, and data URLs only. Do not reference CDNs, remote fonts, scripts, stylesheets, images, APIs, iframes, or forms that submit to a server; the viewer's content policy blocks them.
|
|
28
|
+
- Keep state local to the page. Do not assume cookies, same-origin access, parent-page DOM access, or unrestricted storage.
|
|
29
|
+
- Escape or safely encode any user-supplied text inserted into markup or JavaScript.
|
|
30
|
+
- Include real requested content. Do not leave placeholder buttons, lorem ipsum, TODOs, or controls that appear functional but do nothing.
|
|
31
|
+
|
|
32
|
+
Before saving, check that the HTML is complete, that every visible control has a working local behaviour, and that the document remains understandable at narrow and wide widths.
|
|
33
|
+
|
|
34
|
+
## 3. Save it as an Artifact
|
|
35
|
+
|
|
36
|
+
Choose a concise kebab-case filename ending in `.html` and a one-sentence description.
|
|
37
|
+
|
|
38
|
+
For a project artifact, call `create_attachment` with:
|
|
39
|
+
|
|
40
|
+
- the resolved `workspaceIdentifier` and `projectIdentifier`
|
|
41
|
+
- `textContent`: the complete HTML document
|
|
42
|
+
- `mimeType`: `text/html`
|
|
43
|
+
- `fileName`: the `.html` filename
|
|
44
|
+
- `description`: what the artifact does
|
|
45
|
+
- optional resolved `taskId`
|
|
46
|
+
- `public: false`, unless the user explicitly requested a public/shareable artifact
|
|
47
|
+
|
|
48
|
+
For a personal-note artifact, call `create_note_attachment` with:
|
|
49
|
+
|
|
50
|
+
- `noteId`
|
|
51
|
+
- `textContent`: the complete HTML document
|
|
52
|
+
- `mimeType`: `text/html`
|
|
53
|
+
- `fileName` and `description`
|
|
54
|
+
|
|
55
|
+
Note attachments are always created private. Publishing the note is a separate, explicit action outside this skill.
|
|
56
|
+
|
|
57
|
+
## 4. Report the result
|
|
58
|
+
|
|
59
|
+
Return the artifact name and the exact viewer URL from the tool response. Say where it was saved (project Drive or the named personal note) and whether it is private or public. Do not construct a URL yourself, expose storage keys, or claim success if Xevy did not store the artifact.
|
|
60
|
+
|
|
61
|
+
If the user asks for a non-HTML artifact format, explain briefly that `create-artifact` currently supports HTML only and offer the closest existing capability instead of silently changing formats.
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
{
|
|
2
|
+
"skill_name": "create-artifact",
|
|
3
|
+
"evals": [
|
|
4
|
+
{
|
|
5
|
+
"id": 1,
|
|
6
|
+
"prompt": "Create an interactive break-even calculator for a subscription product. Let me change price, monthly fixed costs, and cost per customer, and show the customer count needed to break even. Save it in this project's Drive.",
|
|
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
|
+
"files": [],
|
|
9
|
+
"expectations": [
|
|
10
|
+
"The HTML contains working local controls and recalculates the break-even customer count.",
|
|
11
|
+
"The artifact has no external scripts, styles, fonts, images, frames, or network requests.",
|
|
12
|
+
"create_attachment is called with textContent, mimeType text/html, an .html filename, and public false.",
|
|
13
|
+
"The final response uses the viewer URL returned by Xevy."
|
|
14
|
+
]
|
|
15
|
+
},
|
|
16
|
+
{
|
|
17
|
+
"id": 2,
|
|
18
|
+
"prompt": "Make a compact interactive HTML explainer of our release flow: draft → ready → in progress → review → done. Clicking each stage should reveal who owns it and the exit criteria. Attach it to note 2be7c3e8-1d14-4de1-9463-4a4f8f0995e9.",
|
|
19
|
+
"expected_output": "A keyboard-accessible, self-contained HTML flow explainer stored in Personal Drive and inserted inline into the specified note.",
|
|
20
|
+
"files": [],
|
|
21
|
+
"expectations": [
|
|
22
|
+
"The artifact presents all five stages and lets keyboard and pointer users reveal stage details.",
|
|
23
|
+
"The page is responsive and honours reduced-motion preferences.",
|
|
24
|
+
"create_note_attachment is called with the supplied noteId, textContent, mimeType text/html, and an .html filename.",
|
|
25
|
+
"The final response states that the artifact is private and attached to the note."
|
|
26
|
+
]
|
|
27
|
+
},
|
|
28
|
+
{
|
|
29
|
+
"id": 3,
|
|
30
|
+
"prompt": "Build a public one-page HTML status dashboard for task VI42-07 with three service indicators, an incident timeline, and a button that switches between current status and maintenance details.",
|
|
31
|
+
"expected_output": "A self-contained HTML status dashboard linked to the resolved task, explicitly public because the user requested it, and saved as an Artifact in Drive.",
|
|
32
|
+
"files": [],
|
|
33
|
+
"expectations": [
|
|
34
|
+
"find_task is used to resolve VI42-07 before artifact creation.",
|
|
35
|
+
"The HTML includes three service indicators, an incident timeline, and a working local view switch.",
|
|
36
|
+
"create_attachment receives the resolved taskId and public true.",
|
|
37
|
+
"The result is reported with Xevy's returned viewer URL and public state."
|
|
38
|
+
]
|
|
39
|
+
}
|
|
40
|
+
]
|
|
41
|
+
}
|