website-build-skill 0.1.7 → 0.1.9
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/.claude-plugin/plugin.json +1 -1
- package/CHANGELOG.md +15 -0
- package/docs/PROVENANCE.md +14 -0
- package/docs/bundles/checklists.md +3 -3
- package/docs/bundles/prompts.md +3 -0
- package/docs/evidence/content-review.json +3 -3
- package/llms.txt +2 -2
- package/package.json +1 -1
- package/skills/website-build-skill/checklists/brand-and-mockups.md +1 -1
- package/skills/website-build-skill/checklists/build.md +1 -1
- package/skills/website-build-skill/checklists/code-quality.md +1 -1
- package/skills/website-build-skill/manifest.json +5 -5
- package/skills/website-build-skill/prompts/04-three-mockups.md +3 -0
- package/src/bundle.mjs +4 -1
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "website-build-skill",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.9",
|
|
4
4
|
"description": "A skill pack that turns your AI into an expert website builder: current research, design, code, accessibility, speed, SEO and security, alone or as a team.",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "website-build-skill contributors"
|
package/CHANGELOG.md
CHANGED
|
@@ -6,6 +6,21 @@ Version policy: [Semantic Versioning 2.0.0](https://semver.org/spec/v2.0.0.html)
|
|
|
6
6
|
|
|
7
7
|
## [Unreleased]
|
|
8
8
|
|
|
9
|
+
## [0.1.9] - 2026-09-26
|
|
10
|
+
|
|
11
|
+
### Fixed
|
|
12
|
+
|
|
13
|
+
- `llms.txt` labels: the manifest entry names what it indexes instead of the bare word "manifest", and a label no longer ends in a colon. A test fails if any catalog label ends in a colon or is a bare asset kind.
|
|
14
|
+
|
|
15
|
+
## [0.1.8] - 2026-09-26
|
|
16
|
+
|
|
17
|
+
### Added
|
|
18
|
+
|
|
19
|
+
- Web design review in the existing checks. BM05 now names common template tells (gradient heading text, side-stripe card borders, the generic purple-to-blue palette, nested cards, icon-tile stacks, bounce easing, decorative numbered labels, thin border with a wide soft shadow) and contextual landing-page layout defaults. A recorded brand decision overrides each default, and text expansion, zoom and reflow always win.
|
|
20
|
+
- CQ06 checks design-token drift and repeated copy-paste shortcuts, and asks that findings be verified in source before they are reported. B08 replays the chosen layout defaults on the built page at the recorded mobile and desktop viewports.
|
|
21
|
+
- Prompt 04 opens with a one-line design read (page type, audience, direction) and points to BM05.
|
|
22
|
+
- `docs/PROVENANCE.md` credits the techniques to Impeccable (Apache-2.0) and Taste Skill (MIT). No upstream text was copied and no dependency was added.
|
|
23
|
+
|
|
9
24
|
## [0.1.7] - 2026-09-25
|
|
10
25
|
|
|
11
26
|
### Changed
|
package/docs/PROVENANCE.md
CHANGED
|
@@ -13,6 +13,20 @@ Reported historical measurements are not repeated as package evidence.
|
|
|
13
13
|
Original package work uses [MIT](../LICENSE). The conduct text retains its own attribution and license.
|
|
14
14
|
No third-party site screenshots, fonts or brand kits are included.
|
|
15
15
|
|
|
16
|
+
## Design review techniques
|
|
17
|
+
|
|
18
|
+
Two techniques adapted (own wording, not copied text) into checklists/brand-and-mockups.md (BM05),
|
|
19
|
+
checklists/code-quality.md (CQ06), checklists/build.md (B08) and prompts/04-three-mockups.md:
|
|
20
|
+
|
|
21
|
+
- Design Read (recording page type, audience and intended visual direction before judging a design)
|
|
22
|
+
and contextual landing-page layout defaults: adapted from Taste Skill,
|
|
23
|
+
[github.com/Leonxlnx/taste-skill](https://github.com/Leonxlnx/taste-skill), commit
|
|
24
|
+
`ce26fc25c0e5e8cab638f883de62d9a86ee5e45b`, MIT licence.
|
|
25
|
+
- A named template-tell check (signs of generic AI-template output) and separating measurable
|
|
26
|
+
findings from visual judgment with in-context verification: adapted from Impeccable,
|
|
27
|
+
[github.com/pbakaus/impeccable](https://github.com/pbakaus/impeccable), commit
|
|
28
|
+
`9d715cc4f5564a990ca8345abfdd5df6dc9b41c8`, Apache-2.0 licence.
|
|
29
|
+
|
|
16
30
|
## Reference ledger
|
|
17
31
|
|
|
18
32
|
These links are research entrypoints, not evidence that this package was loaded in a client.
|
|
@@ -160,7 +160,7 @@ Date rule: [ASK DATE, source evidence, and revalidation](../../skills/website-bu
|
|
|
160
160
|
| BM02: provenance and conflicts | A screenshot estimate is called exact, an inference becomes approved, or conflicting accents are silently collapsed. | Inspect original approved assets and styles; record each value's source, method, confidence, role, and explicit conflict disposition in BRAND.md and tokens.json. |
|
|
161
161
|
| BM03: computed brand contrast | Any contrast claim lacks a computed ratio or ignores a relevant composited state. | Apply accessibility.md AX01 to brand/contrast.md; require tool, actual colors, size/weight, criterion, raw ratio, and result for text/actions/focus. |
|
|
162
162
|
| BM04: three visual directions | Fewer than three inspectable directions, recolored copies, or text wireframes presented as mockups. | Open one image file (PNG, JPEG, WebP or SVG) per direction and viewport (desktop and mobile), plus comparison.md. A static HTML preview is optional; text alone fails BM04. Compare hierarchy, density, type, composition, imagery, and useful interaction with the same representative content. |
|
|
163
|
-
| BM05: stress and visual fit | Only a short desktop hero was inspected. | Review long headline, dense content, mobile layout, primary CTA, focus and reduced-motion intent; record screenshots and specific findings per direction. |
|
|
163
|
+
| BM05: stress and visual fit | Only a short desktop hero was inspected. | Review long headline, dense content, mobile layout, primary CTA, focus and reduced-motion intent; record screenshots and specific findings per direction. Also check for template tells (gradient text on headings, a side-stripe accent border on cards, the generic purple-blue AI palette, cards nested in cards, icon-tile stacks, bounce/elastic easing, decorative numbered section labels, thin border plus wide soft shadow) and contextual landing-page layout defaults (desktop headline about two lines, short supporting copy, restrained nav height, no long run of identical section layouts, one CTA label per intent, grid cell count matching real content); record the chosen viewport and any approved brand-decision exception, and yield to text expansion, zoom and reflow. |
|
|
164
164
|
| BM06: user selection before code | A guessed approval, unnamed choice, or website scaffolding/markup precedes a named selection. | Read the user's actual decision and selection.md, approved brand revision, and stage chronology. Three visuals and a selected revision are mandatory. |
|
|
165
165
|
| BM07: assets and rights | Released assets lack exact intended-use rights, measured dimensions, or inspected crops/exports. | Read Graphics' authoritative rights ledger and immutable asset manifest; inspect dimensions, compression, safe zones, font embedding/subsetting notices, and alt intent. |
|
|
166
166
|
| BM08: handoff ownership | Designer changes Graphics' rights ledger, or Builder receives unversioned inputs. | Compare ownership, source revisions, asset requests, selected-design receipt, and Coordinator acceptance. Preserve producer originals. |
|
|
@@ -213,7 +213,7 @@ Date rule: [ASK DATE, source evidence, and revalidation](../../skills/website-bu
|
|
|
213
213
|
| B05: context-safe output | Quotes escape attributes, hostile text becomes markup, script terminators escape JSON, or unsafe URL schemes survive. | Render quotes, ampersands, angle brackets, a script terminator plus markup, and a javascript-scheme URL. Parse actual output; require inert text, valid script-safe JSON, and rejected unsafe actions. |
|
|
214
214
|
| B06: state and clock parity | Page, badge, control, feed, and discovery state disagree or dates use an implicit timezone. | Test before/at/after boundaries with an explicit clock and timezone. Verify one shared state decision and a documented rebuild trigger or manual owner. |
|
|
215
215
|
| B07: deterministic clean artifact | The build needs undocumented state, output changes without explained inputs, or generated output was hand edited. | Run the documented clean build, record tool/dependency versions and result, compare repeat output, and preserve artifact identity plus output allowlist. |
|
|
216
|
-
| B08: integration and design fidelity | Integrated assets/discovery drift from approved revisions or selected mockup. | Read source handoffs and compare rendered mobile/desktop output; preserve producer files and identify copied revisions. |
|
|
216
|
+
| B08: integration and design fidelity | Integrated assets/discovery drift from approved revisions or selected mockup. | Read source handoffs and compare rendered mobile/desktop output; preserve producer files and identify copied revisions. Replay the selected layout defaults (brand-and-mockups.md BM05) against the built page at the recorded mobile and desktop viewports, and log any mismatch or approved brand-decision exception. |
|
|
217
217
|
| B09: critical journeys and states | The main action, validation, empty/error/loading/success state, or no-JavaScript content fails. | Exercise each applicable state on the exact candidate and retain route, environment, screenshots, and functional outcomes. Apply accessibility and performance/discovery gates. |
|
|
218
218
|
| B10: truthful handoff | Unrun tests are called passed or output lacks reproduction commands. | Open build receipts, QA reports, limitations, artifact digest, next owners, and the audit packet. BLOCKED checks remain visible. |
|
|
219
219
|
| B11: code quality | Any required code-quality check is FAIL or BLOCKED. | Apply [checklists/code-quality.md](../../skills/website-build-skill/checklists/code-quality.md) CQ01-CQ06 to the exact candidate and coding-standards.md revision; reopen the standards, command output, dependency/security evidence, and Builder's review receipt before handoff. |
|
|
@@ -258,7 +258,7 @@ Date rule: [ASK DATE, source evidence, and revalidation](../../skills/website-bu
|
|
|
258
258
|
| CQ03: executed quality commands | Applicable tests, lint, format checks, or type-checks fail, are unrun, or lack recorded output. | Run the standards file's unit, integration, end-to-end, lint, format-check, and type-check commands on the candidate. Save commands, environment, exit codes, full output, and artifact identity; give inapplicable checks a scope-specific reason. |
|
|
259
259
|
| CQ04: dependency hygiene | A dependency lacks a requirement, versions or lockfile permit unexplained drift, or advisory findings lack disposition. | Compare the dependency inventory with the policy; verify pinned versions, lockfile, reproducible install, and audit command output. Record applicable findings, remediation or evidenced disposition, owners, and recheck dates. |
|
|
260
260
|
| CQ05: secure coding | Templates, scripts, URL handling, or secret boundaries violate the stack's secure-coding rules. | Inspect source and rendered output; run synthetic escaping, script-terminator, unsafe-URL, and invalid-input cases. Record results and a secret-boundary check without recording secret values. |
|
|
261
|
-
| CQ06: review evidence | The candidate lacks a code-review receipt against its standards, or material findings remain unresolved. | Builder records inspected revision, organization/pattern checks, findings, and dispositions before handoff. Reviewer challenges this checklist against the same standards and candidate at Challenge; retain the independent receipt and confirmed-fix regressions for shipment. |
|
|
261
|
+
| CQ06: review evidence | The candidate lacks a code-review receipt against its standards, or material findings remain unresolved. | Builder records inspected revision, organization/pattern checks, findings, and dispositions before handoff. Include design-token drift (hard-coded values bypassing tokens) and repeated copy-paste implementation shortcuts among the pattern checks, and verify each finding in source before recording it. Reviewer challenges this checklist against the same standards and candidate at Challenge; retain the independent receipt and confirmed-fix regressions for shipment. |
|
|
262
262
|
|
|
263
263
|
## Gate receipt
|
|
264
264
|
|
package/docs/bundles/prompts.md
CHANGED
|
@@ -463,6 +463,9 @@ Show me three visual mockups for this website before writing any website code.
|
|
|
463
463
|
Use the approved brief, research, brand kit, and representative real content.
|
|
464
464
|
If the brand kit is missing, first ask for my profile-picture and banner screenshots.
|
|
465
465
|
|
|
466
|
+
DESIGN READ
|
|
467
|
+
- Before judging the three directions, note the page type, the audience, and the intended visual direction. See checklists/brand-and-mockups.md BM05.
|
|
468
|
+
|
|
466
469
|
RESEARCH INTO DESIGN
|
|
467
470
|
- Inspect the researched award-winning work and browser possibilities.
|
|
468
471
|
- Borrow principles, not another site's identity, assets, or exact composition.
|
|
@@ -10,9 +10,9 @@
|
|
|
10
10
|
"disposition": "instructions-and-qualified-status-only"
|
|
11
11
|
},
|
|
12
12
|
"CHANGELOG.md": {
|
|
13
|
-
"sha256": "
|
|
13
|
+
"sha256": "8644ca0af5f015c3326b2a0b99ae7c78f428ad1f3ef861f1413217db44a78793",
|
|
14
14
|
"disposition": "instructions-and-qualified-status-only",
|
|
15
|
-
"review": "0.1.2: the installer prompt block became a two-row choice table and one save-location sentence; reviewed by Claude against install-choice.txt and SKILL.md, same facts. Reviewed the added 0.1.1 framing note against the presentation copy changes; publication is a separate release action. Implementation-agent editorial review; independent review remains pending. Reviewed the copied-install checker ladder fix against the canonical instructions and regression test. Live host retrial remains pending release. Reviewed for the ROUND 1 audit: added Fixed/Added/Changed lines for the restored positive-and-accurate adapter, SKILL.md, designer.md, grok.md and validate.mjs fixes. Claude (builder, non-author fixer) editorial review; independent review remains pending. 0.1.3: reviewed the #13 description check and #14 Hermes path documentation entries against the implementation and regression tests; publication remains a separate maintainer action. Implementation-agent editorial review; independent review remains pending. 0.1.4: reviewed the added coding-research description and fourteen-domain wording against the canonical prompts and checklists; package release remains a separate maintainer action. Implementation-agent editorial review; independent review remains pending. Reviewed #16 manual-gate instructions against the explicit skips, packed consumer test and configured OS matrix; reviewed #17 TEAM wording against file-only installation and human session/handoff responsibilities. Implementation-agent editorial review only; host trials and independent review remain pending. Reviewed the #15 Fixed line for the symlinked-parent receipt path against src/install.mjs and installer tests 7e-7g, and the #15 Added line against the two receipts. 0.1.5 (#15): host-status wording promoted only for SOLO native loading on the exact client versions in the 2026-09-24 receipts; Claude (orchestrator, ran both trials) editorial review, independent review remains pending. 0.1.5 release heading moved the Unreleased lines under [0.1.5] - 2026-09-24 unchanged. 0.1.6 (#15): Grok Build CLI 1.0.40 SOLO native-loading receipt added; wording promoted only for that client, in a trusted folder, one run; Grok Bot (Bots app) stays awaiting its trial. Claude (orchestrator, ran the trial) editorial review, independent review remains pending. 0.1.7: Grok Bot setup and one-description entries reviewed against the diff. Claude editorial review."
|
|
15
|
+
"review": "0.1.2: the installer prompt block became a two-row choice table and one save-location sentence; reviewed by Claude against install-choice.txt and SKILL.md, same facts. Reviewed the added 0.1.1 framing note against the presentation copy changes; publication is a separate release action. Implementation-agent editorial review; independent review remains pending. Reviewed the copied-install checker ladder fix against the canonical instructions and regression test. Live host retrial remains pending release. Reviewed for the ROUND 1 audit: added Fixed/Added/Changed lines for the restored positive-and-accurate adapter, SKILL.md, designer.md, grok.md and validate.mjs fixes. Claude (builder, non-author fixer) editorial review; independent review remains pending. 0.1.3: reviewed the #13 description check and #14 Hermes path documentation entries against the implementation and regression tests; publication remains a separate maintainer action. Implementation-agent editorial review; independent review remains pending. 0.1.4: reviewed the added coding-research description and fourteen-domain wording against the canonical prompts and checklists; package release remains a separate maintainer action. Implementation-agent editorial review; independent review remains pending. Reviewed #16 manual-gate instructions against the explicit skips, packed consumer test and configured OS matrix; reviewed #17 TEAM wording against file-only installation and human session/handoff responsibilities. Implementation-agent editorial review only; host trials and independent review remain pending. Reviewed the #15 Fixed line for the symlinked-parent receipt path against src/install.mjs and installer tests 7e-7g, and the #15 Added line against the two receipts. 0.1.5 (#15): host-status wording promoted only for SOLO native loading on the exact client versions in the 2026-09-24 receipts; Claude (orchestrator, ran both trials) editorial review, independent review remains pending. 0.1.5 release heading moved the Unreleased lines under [0.1.5] - 2026-09-24 unchanged. 0.1.6 (#15): Grok Build CLI 1.0.40 SOLO native-loading receipt added; wording promoted only for that client, in a trusted folder, one run; Grok Bot (Bots app) stays awaiting its trial. Claude (orchestrator, ran the trial) editorial review, independent review remains pending. 0.1.7: Grok Bot setup and one-description entries reviewed against the diff. Claude editorial review. 0.1.8: reviewed the Added lines against the committed BM05, CQ06, B08, prompt 04 and PROVENANCE.md diff; every named tell, default and credit matches the checklist text. Claude editorial review; the change itself had an independent codex audit (CLEAN). 0.1.9: reviewed the Fixed line against the src/bundle.mjs describe() diff, the regenerated llms.txt lines 19 and 21 and test/llms-labels.test.mjs. Claude editorial review; the change had an independent codex audit (CLEAN)."
|
|
16
16
|
},
|
|
17
17
|
"CLAUDE.md": {
|
|
18
18
|
"sha256": "4bc19853ddcdea0b2b751f82fba1d7c2451d2ae42f173dba1da2f6035df6e464",
|
|
@@ -188,7 +188,7 @@
|
|
|
188
188
|
"review": "0.1.4: reviewed the added coding-research description and fourteen-domain wording against the canonical prompts and checklists; package release remains a separate maintainer action. Implementation-agent editorial review; independent review remains pending. Reviewed #16 manual-gate instructions against the explicit skips, packed consumer test and configured OS matrix; reviewed #17 TEAM wording against file-only installation and human session/handoff responsibilities. Implementation-agent editorial review only; host trials and independent review remain pending."
|
|
189
189
|
},
|
|
190
190
|
"docs/PROVENANCE.md": {
|
|
191
|
-
"sha256": "
|
|
191
|
+
"sha256": "d7e464f6deaed305987e8720a64bf10ce8880f205a7bc17a0ad82840b8cccf8f",
|
|
192
192
|
"disposition": "evidence-backed",
|
|
193
193
|
"claims": [
|
|
194
194
|
{
|
package/llms.txt
CHANGED
|
@@ -16,9 +16,9 @@ TEAM: one command installs the seven workers' files; you open each session yours
|
|
|
16
16
|
## Active sources
|
|
17
17
|
|
|
18
18
|
- [SKILL.md](skills/website-build-skill/SKILL.md): Website Build Skill
|
|
19
|
-
- [manifest.json](skills/website-build-skill/manifest.json):
|
|
19
|
+
- [manifest.json](skills/website-build-skill/manifest.json): Index of all 57 skill assets with kind, version and bundles, plus the stage gates
|
|
20
20
|
- [prompts/00-start.md](skills/website-build-skill/prompts/00-start.md): Help me build a website using Research. Learn. Ingest. Execute: Match. Mock. Build. Pro...
|
|
21
|
-
- [prompts/01-website-deep-research.md](skills/website-build-skill/prompts/01-website-deep-research.md): Deep Research prompt to make your agent good at building websites
|
|
21
|
+
- [prompts/01-website-deep-research.md](skills/website-build-skill/prompts/01-website-deep-research.md): Deep Research prompt to make your agent good at building websites
|
|
22
22
|
- [prompts/03-extract-brand-kit.md](skills/website-build-skill/prompts/03-extract-brand-kit.md): Turn my approved materials into a brand kit that a website builder can use and test.
|
|
23
23
|
- [prompts/04-three-mockups.md](skills/website-build-skill/prompts/04-three-mockups.md): Show me three visual mockups for this website before writing any website code.
|
|
24
24
|
- [prompts/05-stack-and-build.md](skills/website-build-skill/prompts/05-stack-and-build.md): Build the selected design using the smallest stack that meets the approved brief.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "website-build-skill",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.9",
|
|
4
4
|
"description": "A skill pack that turns your AI into an expert website builder: current research, design, code, accessibility, speed, SEO and security, alone or as a team.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
@@ -24,7 +24,7 @@ Date rule: [ASK DATE, source evidence, and revalidation](../playbooks/research-a
|
|
|
24
24
|
| BM02: provenance and conflicts | A screenshot estimate is called exact, an inference becomes approved, or conflicting accents are silently collapsed. | Inspect original approved assets and styles; record each value's source, method, confidence, role, and explicit conflict disposition in BRAND.md and tokens.json. |
|
|
25
25
|
| BM03: computed brand contrast | Any contrast claim lacks a computed ratio or ignores a relevant composited state. | Apply accessibility.md AX01 to brand/contrast.md; require tool, actual colors, size/weight, criterion, raw ratio, and result for text/actions/focus. |
|
|
26
26
|
| BM04: three visual directions | Fewer than three inspectable directions, recolored copies, or text wireframes presented as mockups. | Open one image file (PNG, JPEG, WebP or SVG) per direction and viewport (desktop and mobile), plus comparison.md. A static HTML preview is optional; text alone fails BM04. Compare hierarchy, density, type, composition, imagery, and useful interaction with the same representative content. |
|
|
27
|
-
| BM05: stress and visual fit | Only a short desktop hero was inspected. | Review long headline, dense content, mobile layout, primary CTA, focus and reduced-motion intent; record screenshots and specific findings per direction. |
|
|
27
|
+
| BM05: stress and visual fit | Only a short desktop hero was inspected. | Review long headline, dense content, mobile layout, primary CTA, focus and reduced-motion intent; record screenshots and specific findings per direction. Also check for template tells (gradient text on headings, a side-stripe accent border on cards, the generic purple-blue AI palette, cards nested in cards, icon-tile stacks, bounce/elastic easing, decorative numbered section labels, thin border plus wide soft shadow) and contextual landing-page layout defaults (desktop headline about two lines, short supporting copy, restrained nav height, no long run of identical section layouts, one CTA label per intent, grid cell count matching real content); record the chosen viewport and any approved brand-decision exception, and yield to text expansion, zoom and reflow. |
|
|
28
28
|
| BM06: user selection before code | A guessed approval, unnamed choice, or website scaffolding/markup precedes a named selection. | Read the user's actual decision and selection.md, approved brand revision, and stage chronology. Three visuals and a selected revision are mandatory. |
|
|
29
29
|
| BM07: assets and rights | Released assets lack exact intended-use rights, measured dimensions, or inspected crops/exports. | Read Graphics' authoritative rights ledger and immutable asset manifest; inspect dimensions, compression, safe zones, font embedding/subsetting notices, and alt intent. |
|
|
30
30
|
| BM08: handoff ownership | Designer changes Graphics' rights ledger, or Builder receives unversioned inputs. | Compare ownership, source revisions, asset requests, selected-design receipt, and Coordinator acceptance. Preserve producer originals. |
|
|
@@ -27,7 +27,7 @@ Date rule: [ASK DATE, source evidence, and revalidation](../playbooks/research-a
|
|
|
27
27
|
| B05: context-safe output | Quotes escape attributes, hostile text becomes markup, script terminators escape JSON, or unsafe URL schemes survive. | Render quotes, ampersands, angle brackets, a script terminator plus markup, and a javascript-scheme URL. Parse actual output; require inert text, valid script-safe JSON, and rejected unsafe actions. |
|
|
28
28
|
| B06: state and clock parity | Page, badge, control, feed, and discovery state disagree or dates use an implicit timezone. | Test before/at/after boundaries with an explicit clock and timezone. Verify one shared state decision and a documented rebuild trigger or manual owner. |
|
|
29
29
|
| B07: deterministic clean artifact | The build needs undocumented state, output changes without explained inputs, or generated output was hand edited. | Run the documented clean build, record tool/dependency versions and result, compare repeat output, and preserve artifact identity plus output allowlist. |
|
|
30
|
-
| B08: integration and design fidelity | Integrated assets/discovery drift from approved revisions or selected mockup. | Read source handoffs and compare rendered mobile/desktop output; preserve producer files and identify copied revisions. |
|
|
30
|
+
| B08: integration and design fidelity | Integrated assets/discovery drift from approved revisions or selected mockup. | Read source handoffs and compare rendered mobile/desktop output; preserve producer files and identify copied revisions. Replay the selected layout defaults (brand-and-mockups.md BM05) against the built page at the recorded mobile and desktop viewports, and log any mismatch or approved brand-decision exception. |
|
|
31
31
|
| B09: critical journeys and states | The main action, validation, empty/error/loading/success state, or no-JavaScript content fails. | Exercise each applicable state on the exact candidate and retain route, environment, screenshots, and functional outcomes. Apply accessibility and performance/discovery gates. |
|
|
32
32
|
| B10: truthful handoff | Unrun tests are called passed or output lacks reproduction commands. | Open build receipts, QA reports, limitations, artifact digest, next owners, and the audit packet. BLOCKED checks remain visible. |
|
|
33
33
|
| B11: code quality | Any required code-quality check is FAIL or BLOCKED. | Apply [checklists/code-quality.md](code-quality.md) CQ01-CQ06 to the exact candidate and coding-standards.md revision; reopen the standards, command output, dependency/security evidence, and Builder's review receipt before handoff. |
|
|
@@ -25,7 +25,7 @@ Date rule: [ASK DATE, source evidence, and revalidation](../playbooks/research-a
|
|
|
25
25
|
| CQ03: executed quality commands | Applicable tests, lint, format checks, or type-checks fail, are unrun, or lack recorded output. | Run the standards file's unit, integration, end-to-end, lint, format-check, and type-check commands on the candidate. Save commands, environment, exit codes, full output, and artifact identity; give inapplicable checks a scope-specific reason. |
|
|
26
26
|
| CQ04: dependency hygiene | A dependency lacks a requirement, versions or lockfile permit unexplained drift, or advisory findings lack disposition. | Compare the dependency inventory with the policy; verify pinned versions, lockfile, reproducible install, and audit command output. Record applicable findings, remediation or evidenced disposition, owners, and recheck dates. |
|
|
27
27
|
| CQ05: secure coding | Templates, scripts, URL handling, or secret boundaries violate the stack's secure-coding rules. | Inspect source and rendered output; run synthetic escaping, script-terminator, unsafe-URL, and invalid-input cases. Record results and a secret-boundary check without recording secret values. |
|
|
28
|
-
| CQ06: review evidence | The candidate lacks a code-review receipt against its standards, or material findings remain unresolved. | Builder records inspected revision, organization/pattern checks, findings, and dispositions before handoff. Reviewer challenges this checklist against the same standards and candidate at Challenge; retain the independent receipt and confirmed-fix regressions for shipment. |
|
|
28
|
+
| CQ06: review evidence | The candidate lacks a code-review receipt against its standards, or material findings remain unresolved. | Builder records inspected revision, organization/pattern checks, findings, and dispositions before handoff. Include design-token drift (hard-coded values bypassing tokens) and repeated copy-paste implementation shortcuts among the pattern checks, and verify each finding in source before recording it. Reviewer challenges this checklist against the same standards and candidate at Challenge; retain the independent receipt and confirmed-fix regressions for shipment. |
|
|
29
29
|
|
|
30
30
|
## Gate receipt
|
|
31
31
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": 1,
|
|
3
|
-
"packageVersion": "0.1.
|
|
3
|
+
"packageVersion": "0.1.9",
|
|
4
4
|
"skillName": "website-build-skill",
|
|
5
5
|
"pathBase": "All asset paths resolve from this manifest directory; runtime paths resolve in the authorized user project.",
|
|
6
6
|
"assets": [
|
|
@@ -104,7 +104,7 @@
|
|
|
104
104
|
"skill-zip",
|
|
105
105
|
"native-skill"
|
|
106
106
|
],
|
|
107
|
-
"sha256": "
|
|
107
|
+
"sha256": "9881d8c5ae027d57288f40b50621142b5dc66efd989796ee2b12a420d6dba953"
|
|
108
108
|
},
|
|
109
109
|
{
|
|
110
110
|
"path": "prompts/05-stack-and-build.md",
|
|
@@ -542,7 +542,7 @@
|
|
|
542
542
|
"skill-zip",
|
|
543
543
|
"native-skill"
|
|
544
544
|
],
|
|
545
|
-
"sha256": "
|
|
545
|
+
"sha256": "774d08f3093a3668d874074f9c5cc7435d089997a3c850afb6ae0553287bcc46"
|
|
546
546
|
},
|
|
547
547
|
{
|
|
548
548
|
"path": "checklists/build.md",
|
|
@@ -557,7 +557,7 @@
|
|
|
557
557
|
"skill-zip",
|
|
558
558
|
"native-skill"
|
|
559
559
|
],
|
|
560
|
-
"sha256": "
|
|
560
|
+
"sha256": "ccc6b3de61ae7ab4b2d052b970b956695a52fba4c3fd24750439da3a8df2b69f"
|
|
561
561
|
},
|
|
562
562
|
{
|
|
563
563
|
"path": "checklists/code-quality.md",
|
|
@@ -572,7 +572,7 @@
|
|
|
572
572
|
"skill-zip",
|
|
573
573
|
"native-skill"
|
|
574
574
|
],
|
|
575
|
-
"sha256": "
|
|
575
|
+
"sha256": "c2d1aa467a5ab9d4b8846c4fdefbd3c8efbb2f342e05d5526e2059a4ddb4d926"
|
|
576
576
|
},
|
|
577
577
|
{
|
|
578
578
|
"path": "checklists/accessibility.md",
|
|
@@ -7,6 +7,9 @@ Show me three visual mockups for this website before writing any website code.
|
|
|
7
7
|
Use the approved brief, research, brand kit, and representative real content.
|
|
8
8
|
If the brand kit is missing, first ask for my profile-picture and banner screenshots.
|
|
9
9
|
|
|
10
|
+
DESIGN READ
|
|
11
|
+
- Before judging the three directions, note the page type, the audience, and the intended visual direction. See checklists/brand-and-mockups.md BM05.
|
|
12
|
+
|
|
10
13
|
RESEARCH INTO DESIGN
|
|
11
14
|
- Inspect the researched award-winning work and browser possibilities.
|
|
12
15
|
- Borrow principles, not another site's identity, assets, or exact composition.
|
package/src/bundle.mjs
CHANGED
|
@@ -69,7 +69,8 @@ export function rebase(text, source, target) {
|
|
|
69
69
|
// only falls back to the bare asset kind when nothing readable is found. Never hand-write
|
|
70
70
|
// this text in llms.txt itself: it is derived here so the catalog stays truthful as files change.
|
|
71
71
|
export function describe(root, asset) {
|
|
72
|
-
|
|
72
|
+
// A label ending in a colon reads as a cut-off lead-in in the catalog, so it is dropped.
|
|
73
|
+
const truncate = s => (s.length > 90 ? s.slice(0, 87).trimEnd() + '...' : s).replace(/:\s*$/, '');
|
|
73
74
|
const plain = s => s.replace(/\[([^\]]+)\]\([^)]*\)/g, '$1').replace(/[`*_]/g, '').trim();
|
|
74
75
|
// Several role/prompt files open with the same shared ASK DATE preamble, so it names the
|
|
75
76
|
// convention every file follows rather than what that specific file teaches. Skip it when
|
|
@@ -79,6 +80,8 @@ export function describe(root, asset) {
|
|
|
79
80
|
try {
|
|
80
81
|
const data = JSON.parse(read(root, `${CORE}/${asset.path}`));
|
|
81
82
|
if (typeof data.description === 'string' && data.description.trim()) return truncate(plain(data.description));
|
|
83
|
+
// The skill manifest carries no description field; name what it indexes instead of its kind.
|
|
84
|
+
if (Array.isArray(data.assets)) return `Index of all ${data.assets.length} skill assets with kind, version and bundles, plus the stage gates`;
|
|
82
85
|
} catch { /* not readable JSON; fall through to kind */ }
|
|
83
86
|
return asset.kind;
|
|
84
87
|
}
|