@a13xu/lucid 1.16.0 → 1.16.2
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.
- package/README.md +147 -21
- package/build/compression/semantic.js +5 -1
- package/build/guardian/checklist.d.ts +2 -1
- package/build/guardian/checklist.js +20 -1
- package/build/guardian/coding-rules.d.ts +2 -1
- package/build/guardian/coding-rules.js +20 -1
- package/build/index.js +491 -742
- package/build/tools/plan.js +2 -2
- package/package.json +3 -1
- package/skills/lucid-audit/SKILL.md +84 -73
- package/skills/lucid-context/SKILL.md +78 -69
- package/skills/lucid-plan/SKILL.md +61 -52
- package/skills/lucid-security/SKILL.md +50 -41
- package/skills/lucid-start/SKILL.md +79 -70
- package/skills/lucid-webdev/SKILL.md +59 -45
|
@@ -1,70 +1,79 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: lucid-start
|
|
3
|
-
description: MANDATORY at every session start and before any coding task — loads project context via Lucid before Claude reads any file or writes any code
|
|
4
|
-
argument-hint: "[optional: what you are about to work on]"
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
-
|
|
10
|
-
-
|
|
11
|
-
-
|
|
12
|
-
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
1
|
+
---
|
|
2
|
+
name: lucid-start
|
|
3
|
+
description: MANDATORY at every session start and before any coding task — loads project context via Lucid before Claude reads any file or writes any code
|
|
4
|
+
argument-hint: "[optional: what you are about to work on]"
|
|
5
|
+
allowed-tools:
|
|
6
|
+
- mcp__lucid__suggest_model
|
|
7
|
+
- mcp__lucid__init_project
|
|
8
|
+
- mcp__lucid__sync_file
|
|
9
|
+
- mcp__lucid__sync_project
|
|
10
|
+
- mcp__lucid__memory_stats
|
|
11
|
+
- mcp__lucid__recall
|
|
12
|
+
- mcp__lucid__get_recent
|
|
13
|
+
- mcp__lucid__smart_context
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
<HARD-GATE>
|
|
17
|
+
You MUST complete ALL steps below BEFORE:
|
|
18
|
+
- Reading any source file
|
|
19
|
+
- Writing or editing any code
|
|
20
|
+
- Answering any coding question
|
|
21
|
+
- Creating any plan or task
|
|
22
|
+
|
|
23
|
+
This is not optional. There are no exceptions. "I'll do it after" is not acceptable.
|
|
24
|
+
</HARD-GATE>
|
|
25
|
+
|
|
26
|
+
## Steps (all mandatory, in order)
|
|
27
|
+
|
|
28
|
+
### 0. Get model recommendation
|
|
29
|
+
```
|
|
30
|
+
suggest_model(task_description="<paste the user's task description>")
|
|
31
|
+
```
|
|
32
|
+
Say: **"Using [model] — [reasoning]"** then proceed.
|
|
33
|
+
|
|
34
|
+
### 1. Check what changed recently
|
|
35
|
+
```
|
|
36
|
+
get_recent(hours=48)
|
|
37
|
+
```
|
|
38
|
+
This shows files modified since your last session. Review the list.
|
|
39
|
+
|
|
40
|
+
### 2. If working on a specific task — load relevant context
|
|
41
|
+
```
|
|
42
|
+
smart_context(query="<describe what you are about to work on>", task_type="moderate")
|
|
43
|
+
```
|
|
44
|
+
If the user's request involves code, call smart_context. For purely conversational exchanges with zero code involvement, this step may be omitted.
|
|
45
|
+
|
|
46
|
+
### 3. Announce readiness
|
|
47
|
+
Say: "✓ Lucid active — context loaded"
|
|
48
|
+
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
## After EVERY file write or edit
|
|
52
|
+
|
|
53
|
+
Call `sync_file` IMMEDIATELY after the tool call completes:
|
|
54
|
+
```
|
|
55
|
+
sync_file(path="<exact path of file you just wrote or edited>")
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
**Do this before anything else.** Before the next file. Before the next thought. Now.
|
|
59
|
+
|
|
60
|
+
If you modified multiple files (refactor, git pull): call `sync_project()` instead.
|
|
61
|
+
|
|
62
|
+
---
|
|
63
|
+
|
|
64
|
+
## Before marking any task as done
|
|
65
|
+
|
|
66
|
+
Run /lucid-audit before saying "done", "fixed", "complete", or "implemented".
|
|
67
|
+
|
|
68
|
+
---
|
|
69
|
+
|
|
70
|
+
## Trigger conditions
|
|
71
|
+
|
|
72
|
+
**USE this skill:**
|
|
73
|
+
- At the start of every new conversation
|
|
74
|
+
- When resuming work after a break
|
|
75
|
+
- When the user says "let's work on X" or similar
|
|
76
|
+
|
|
77
|
+
**DO NOT USE for:**
|
|
78
|
+
- Pure conversation with no code involved
|
|
79
|
+
- Answering theoretical questions
|
|
@@ -1,45 +1,59 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: lucid-webdev
|
|
3
|
-
description: Use for web development tasks — generates components, pages, audits, API clients, and performance hints via Lucid's 10 web dev tools.
|
|
4
|
-
argument-hint: "[what you are building: component/page/api/audit]"
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
1
|
+
---
|
|
2
|
+
name: lucid-webdev
|
|
3
|
+
description: Use for web development tasks — generates components, pages, audits, API clients, and performance hints via Lucid's 10 web dev tools.
|
|
4
|
+
argument-hint: "[what you are building: component/page/api/audit]"
|
|
5
|
+
allowed-tools:
|
|
6
|
+
- mcp__lucid__suggest_model
|
|
7
|
+
- mcp__lucid__generate_component
|
|
8
|
+
- mcp__lucid__scaffold_page
|
|
9
|
+
- mcp__lucid__seo_meta
|
|
10
|
+
- mcp__lucid__accessibility_audit
|
|
11
|
+
- mcp__lucid__api_client
|
|
12
|
+
- mcp__lucid__test_generator
|
|
13
|
+
- mcp__lucid__responsive_layout
|
|
14
|
+
- mcp__lucid__security_scan
|
|
15
|
+
- mcp__lucid__design_tokens
|
|
16
|
+
- mcp__lucid__perf_hints
|
|
17
|
+
- Write
|
|
18
|
+
- Edit
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
<HARD-GATE>
|
|
22
|
+
Before building any web component, page, or API client from scratch:
|
|
23
|
+
call the relevant generator tool first. Do not write boilerplate manually.
|
|
24
|
+
</HARD-GATE>
|
|
25
|
+
|
|
26
|
+
## When to invoke
|
|
27
|
+
|
|
28
|
+
**INVOKE when:** building UI components, scaffolding pages, writing API clients, running accessibility/security/performance audits
|
|
29
|
+
**DO NOT INVOKE for:** backend-only logic with no web layer
|
|
30
|
+
|
|
31
|
+
## Steps
|
|
32
|
+
|
|
33
|
+
### 0. Get model recommendation
|
|
34
|
+
```
|
|
35
|
+
suggest_model(task_description="<paste the user's task description>")
|
|
36
|
+
```
|
|
37
|
+
Say: **"Using [model] — [reasoning]"** then proceed.
|
|
38
|
+
|
|
39
|
+
## Available tools
|
|
40
|
+
|
|
41
|
+
| Task | Tool |
|
|
42
|
+
|---|---|
|
|
43
|
+
| Generate a React/Vue component | `generate_component(description, framework, styling, typescript)` |
|
|
44
|
+
| Scaffold a full page | `scaffold_page(page_name, framework, sections, seo_title)` |
|
|
45
|
+
| SEO meta tags | `seo_meta(title, description, keywords, page_type, url, image_url)` |
|
|
46
|
+
| Accessibility audit | `accessibility_audit(code, wcag_level, framework)` |
|
|
47
|
+
| API client | `api_client(endpoint, method, response_schema, auth, base_url_var)` |
|
|
48
|
+
| Test scaffolding | `test_generator(code, test_framework, test_type, component_framework)` |
|
|
49
|
+
| Responsive layout | `responsive_layout(description, framework, breakpoints, container)` |
|
|
50
|
+
| Security scan | `security_scan(code, language, context)` |
|
|
51
|
+
| Design tokens | `design_tokens(brand_name, primary_color, mood, output_format)` |
|
|
52
|
+
| Performance hints | `perf_hints(code, framework, context)` |
|
|
53
|
+
|
|
54
|
+
## Workflow
|
|
55
|
+
|
|
56
|
+
1. Call the relevant generator/auditor tool
|
|
57
|
+
2. Review output → adapt to project conventions
|
|
58
|
+
3. `sync_file(path="<generated file>")` after saving
|
|
59
|
+
4. Run /lucid-audit before marking done
|