From 23b5e12243102f17a648f67fb54cc47babf8febc Mon Sep 17 00:00:00 2001 From: Universe Date: Wed, 22 Apr 2026 23:39:42 +0900 Subject: [PATCH 1/2] skills: convert cg-htmlcss-feature prompt to a skill MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The .agents/ convention (used by Vercel/Next.js, read by opencode and Claude Code) only standardizes .agents/skills/ — there is no portable .agents/prompts/ slot. Move cg-htmlcss-feature under .agents/skills/ with proper SKILL.md frontmatter so it's discoverable as a skill by any compatible agent runtime. The opt-in nature is preserved via the description: load only when the user explicitly requests a full feature cycle, not on every htmlcss edit. --- .../cg-htmlcss-feature/SKILL.md} | 36 +++++++++++-------- 1 file changed, 22 insertions(+), 14 deletions(-) rename .agents/{prompts/cg-htmlcss-feature.md => skills/cg-htmlcss-feature/SKILL.md} (91%) diff --git a/.agents/prompts/cg-htmlcss-feature.md b/.agents/skills/cg-htmlcss-feature/SKILL.md similarity index 91% rename from .agents/prompts/cg-htmlcss-feature.md rename to .agents/skills/cg-htmlcss-feature/SKILL.md index b67bd08e6..1e6e91a31 100644 --- a/.agents/prompts/cg-htmlcss-feature.md +++ b/.agents/skills/cg-htmlcss-feature/SKILL.md @@ -1,18 +1,26 @@ -# cg-htmlcss — feature loop prompt +--- +name: cg-htmlcss-feature +description: > + Drive a single CSS feature end-to-end in the cg htmlcss renderer using a + five-phase loop: audit, ground (spec + Blink/stylo prior art), fixture, + implement, verify. Use when the user explicitly asks for a full feature + cycle on an htmlcss property (e.g. "full loop on border-radius", "bring + to Chromium parity"). Not for small fixes or paper-cuts — this + is an opt-in conductor over /research, /fixtures, /cg-reftest with strict + gate policy (L0.exact at floor 1.0, threshold 0, aa off). Relevant paths: + crates/grida-canvas/src/htmlcss/, fixtures/test-html/L0/, + fixtures/test-html/suites/L0.exact.json, fixtures/test-html/suites/L0.coverage.json. +--- -**What this is.** A pastable prompt template for driving a single CSS -feature forward in the cg htmlcss renderer. Paste the template at the -bottom into a new task; the reference above it is context an agent -can read to follow the loop honestly. +# cg-htmlcss — feature loop -**Why this is a prompt and not a skill.** The 5-phase loop is -deliberately heavy — audit + ground + fixture + implement + verify. -It's overkill for small fixes, and it's already a conductor over -`/research`, `/fixtures`, `/cg-reftest`, which auto-trigger correctly -on their own. Opt-in invocation is right: paste it when you want the -full cycle; skip it for paper-cuts. +**What this is.** A heavy, opt-in loop for driving a single CSS feature +forward in the cg htmlcss renderer. Load this skill when the user asks +for a full feature cycle; skip it for small fixes. The loop is a +conductor over `/research`, `/fixtures`, and `/cg-reftest` — they +auto-trigger on their own for narrower work. -**Lifecycle.** Expect this file to grow as new divergence patterns +**Lifecycle.** Expect this skill to grow as new divergence patterns surface. It will likely go stale in parts once htmlcss hits Chromium-parity on L0/L1; treat the _phase structure_ as durable and the _property-specific callouts_ as advisory. @@ -245,7 +253,7 @@ upstream is advisory; verify is the truth. fixture here is "we know about this case and intend to fix it." Promoting to exact is "we now match Blink." -Automation rules downstream of this prompt (CI gating, auto-merge, +Automation rules downstream of this skill (CI gating, auto-merge, etc.) must assert on the `report.json` emitted by `@grida/reftest` and **not** on free-text agent assertions. The agent's job is to drive the loop; the report is the contract. @@ -291,7 +299,7 @@ without the conversation. ```text Drive the htmlcss feature loop for: . -Follow .agents/prompts/cg-htmlcss-feature.md. +Follow the cg-htmlcss-feature skill (.agents/skills/cg-htmlcss-feature/SKILL.md). Scope: - Feature: From 5dd8fc86e6a9810a44bf2c3caffce0e1422c0cd4 Mon Sep 17 00:00:00 2001 From: Universe Date: Wed, 22 Apr 2026 23:49:08 +0900 Subject: [PATCH 2/2] skills: rename to dev-cg-htmlcss-feature, shorten description Prefix with dev- to signal its prompt-origin and dev-workflow scope. Description shortened since the skill is always manually invoked. --- .../SKILL.md | 26 +++++++------------ 1 file changed, 10 insertions(+), 16 deletions(-) rename .agents/skills/{cg-htmlcss-feature => dev-cg-htmlcss-feature}/SKILL.md (92%) diff --git a/.agents/skills/cg-htmlcss-feature/SKILL.md b/.agents/skills/dev-cg-htmlcss-feature/SKILL.md similarity index 92% rename from .agents/skills/cg-htmlcss-feature/SKILL.md rename to .agents/skills/dev-cg-htmlcss-feature/SKILL.md index 1e6e91a31..c61ecc8d2 100644 --- a/.agents/skills/cg-htmlcss-feature/SKILL.md +++ b/.agents/skills/dev-cg-htmlcss-feature/SKILL.md @@ -1,24 +1,18 @@ --- -name: cg-htmlcss-feature +name: dev-cg-htmlcss-feature description: > - Drive a single CSS feature end-to-end in the cg htmlcss renderer using a - five-phase loop: audit, ground (spec + Blink/stylo prior art), fixture, - implement, verify. Use when the user explicitly asks for a full feature - cycle on an htmlcss property (e.g. "full loop on border-radius", "bring - to Chromium parity"). Not for small fixes or paper-cuts — this - is an opt-in conductor over /research, /fixtures, /cg-reftest with strict - gate policy (L0.exact at floor 1.0, threshold 0, aa off). Relevant paths: - crates/grida-canvas/src/htmlcss/, fixtures/test-html/L0/, - fixtures/test-html/suites/L0.exact.json, fixtures/test-html/suites/L0.coverage.json. + Manual-invocation only. Five-phase feature loop (audit → ground → + fixture → implement → verify) for driving a single CSS feature to + Chromium parity in the cg htmlcss renderer. --- # cg-htmlcss — feature loop -**What this is.** A heavy, opt-in loop for driving a single CSS feature -forward in the cg htmlcss renderer. Load this skill when the user asks -for a full feature cycle; skip it for small fixes. The loop is a -conductor over `/research`, `/fixtures`, and `/cg-reftest` — they -auto-trigger on their own for narrower work. +**What this is.** A heavy, manually-invoked loop for driving a single +CSS feature forward in the cg htmlcss renderer. Do not auto-trigger; +load only when the user explicitly runs it. The loop is a conductor +over `/research`, `/fixtures`, and `/cg-reftest` — those auto-trigger +on their own for narrower work. **Lifecycle.** Expect this skill to grow as new divergence patterns surface. It will likely go stale in parts once htmlcss hits @@ -299,7 +293,7 @@ without the conversation. ```text Drive the htmlcss feature loop for: . -Follow the cg-htmlcss-feature skill (.agents/skills/cg-htmlcss-feature/SKILL.md). +Follow the dev-cg-htmlcss-feature skill (.agents/skills/dev-cg-htmlcss-feature/SKILL.md). Scope: - Feature: