From 8dbfdc66428316086068024267d7799136223561 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Thu, 7 May 2026 11:11:10 +0000 Subject: [PATCH 1/7] feat: add installable SmarkForm AI skill specs and docs guidance Agent-Logs-Url: https://github.com/bitifet/SmarkForm/sessions/9b4bdf31-cf26-44d5-b4c3-1d3eebf2caf0 Co-authored-by: bitifet <1643647+bitifet@users.noreply.github.com> --- AGENTS.md | 18 +++++ docs/_resources/ai-agents.md | 56 ++++++++++++++- skills/SmarkForm-Advanced-Internals.skill.md | 39 ++++++++++ skills/SmarkForm-Form-Builder.skill.md | 75 ++++++++++++++++++++ 4 files changed, 186 insertions(+), 2 deletions(-) create mode 100644 skills/SmarkForm-Advanced-Internals.skill.md create mode 100644 skills/SmarkForm-Form-Builder.skill.md diff --git a/AGENTS.md b/AGENTS.md index 47f66e6b..31062d93 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -40,6 +40,7 @@ When you change or add any of the following, please update this file to reflect - scripts/* (collector, build scripts, live-serve helpers) - rollup.config.js or rollup-plugins/ - docs/ content, co-located examples, or test collection logic +- skills/* (installable AI skill specifications) - .github/workflows/* (CI / Pages deployment) For convenience, include this exact sentence in the PR description when you want the assistant to update AGENTS.md automatically: @@ -360,6 +361,23 @@ When you discover a new pattern, fix a bug caused by an undocumented constraint, 3. **Correct inaccurate entries** whenever you verify that something documented is wrong. 4. You do not need a special PR description sentence to update `AGENTS/` files — just do it as part of your normal work. +## Agent Skills Directory (`skills/`) + +The `skills/` directory contains installable skill specifications that can be +copied into AI tools (opencode and similar) to enforce SmarkForm-specific +implementation behavior. + +| File | Purpose | +|------|---------| +| `skills/SmarkForm-Form-Builder.skill.md` | Core skill for implementing SmarkForm forms with required rules and a mandatory compliance checklist | +| `skills/SmarkForm-Advanced-Internals.skill.md` | Optional advanced skill for internals-heavy work (action semantics, list/context edge cases, security-sensitive patterns) | + +Maintenance rule: +- When `docs/_resources/AGENTS/SmarkForm-Forms.md` or + `docs/_resources/AGENTS/SmarkForm-Usage.md` changes, update affected files in + `skills/` in the same PR so installable skills stay aligned with canonical + docs. + - **Contributing**: See `CONTRIBUTING.md` - **Documentation**: [https://smarkform.bitifet.net](https://smarkform.bitifet.net) diff --git a/docs/_resources/ai-agents.md b/docs/_resources/ai-agents.md index 3a0c447d..0ac30dae 100644 --- a/docs/_resources/ai-agents.md +++ b/docs/_resources/ai-agents.md @@ -16,8 +16,13 @@ nav_order: 6 * [Agent Knowledge Files](#agent-knowledge-files) -* [How to Use These Files When Prompting an AI](#how-to-use-these-files-when-prompting-an-ai) - * [Quick Reference Prompts](#quick-reference-prompts) + * [How to Use These Files When Prompting an AI](#how-to-use-these-files-when-prompting-an-ai) + * [Quick Reference Prompts](#quick-reference-prompts) +* [Installable Skills](#installable-skills) + * [Core Skill (recommended)](#core-skill-recommended) + * [Optional Advanced Skill](#optional-advanced-skill) + * [Import into opencode or similar tools](#import-into-opencode-or-similar-tools) +* [Maintenance Rules for Skill Files](#maintenance-rules-for-skill-files) * [Prompt Templates](#prompt-templates) * [Simple form](#simple-form) * [Form with a repeating list](#form-with-a-repeating-list) @@ -62,6 +67,53 @@ Load SmarkForm from CDN (pin to the latest stable version). --- +## Installable Skills + +The repository includes installable skill specs so AI tools can enforce +SmarkForm-specific implementation rules. + +### Core Skill (recommended) + +- `skills/SmarkForm-Form-Builder.skill.md` + +Use this for general SmarkForm form implementation. It enforces: +- source-priority lookups (deployed docs first) +- event/action-first implementation patterns +- required `await myForm.rendered` timing +- list/context/template rules +- root-level security option rules +- mandatory “SmarkForm compliance checklist” in outputs + +### Optional Advanced Skill + +- `skills/SmarkForm-Advanced-Internals.skill.md` + +Use this when handling advanced internals and edge cases. + +### Import into opencode or similar tools + +1. Open the desired skill file from `skills/`. +2. Copy its full content into your tool's skill/instruction definition. +3. Keep the source-priority section unchanged so the agent always prefers: + - `https://smarkform.bitifet.net/resources/AGENTS/SmarkForm-Forms` + - `https://smarkform.bitifet.net/resources/AGENTS/SmarkForm-Usage` +4. If your tool supports separate skills, install: + - core skill as default + - advanced skill as opt-in + +--- + +## Maintenance Rules for Skill Files + +- When `docs/_resources/AGENTS/SmarkForm-Forms.md` or + `docs/_resources/AGENTS/SmarkForm-Usage.md` changes, update the relevant + files under `skills/` in the same PR. +- Keep the source-priority order intact so deployed docs remain the primary + knowledge source for agents. +- If behavioral rules change, update both the skill file(s) and this page. + +--- + ## Prompt Templates The following ready-to-use prompts are reproduced from the diff --git a/skills/SmarkForm-Advanced-Internals.skill.md b/skills/SmarkForm-Advanced-Internals.skill.md new file mode 100644 index 00000000..2d2be06b --- /dev/null +++ b/skills/SmarkForm-Advanced-Internals.skill.md @@ -0,0 +1,39 @@ +# SmarkForm Advanced Internals — Optional Skill Spec + +## Goal + +Handle advanced SmarkForm internals safely (complex list semantics, action decorator nuances, context/target path edge-cases, and security-related options). + +## Scope + +Use this optional skill for: +- Nested list/template edge cases +- Programmatic action invocation nuances +- Complex `context` / `target` path behavior +- Mixin/security-option-sensitive implementations + +For standard form implementation, use: +- `skills/SmarkForm-Form-Builder.skill.md` + +## Source Priority + +1. https://smarkform.bitifet.net/resources/AGENTS/SmarkForm-Usage +2. https://smarkform.bitifet.net/resources/AGENTS/SmarkForm-Forms +3. `docs/_resources/AGENTS/SmarkForm-Usage.md` +4. `docs/_resources/AGENTS/SmarkForm-Forms.md` +5. `AGENTS/SmarkForm-Usage.md` +6. `AGENTS/SmarkForm-Forms.md` + +## Non-negotiable Internals Rules + +- Respect `@action` calling conventions (including argument position semantics). +- Respect action context resolution and target resolution semantics. +- Respect list template role lifecycle and cloning behavior. +- Apply security-related options at root-level constructor options. + +## Output Requirement + +Provide a short “advanced compliance check” confirming: +- source pages consulted +- internals rules applied +- unresolved ambiguity (if any) diff --git a/skills/SmarkForm-Form-Builder.skill.md b/skills/SmarkForm-Form-Builder.skill.md new file mode 100644 index 00000000..9e547526 --- /dev/null +++ b/skills/SmarkForm-Form-Builder.skill.md @@ -0,0 +1,75 @@ +# SmarkForm Form Builder — Installable Skill Spec + +## Goal + +Generate production-ready SmarkForm forms that follow current SmarkForm patterns and avoid common implementation mistakes. + +## Source Priority (mandatory) + +When implementing or modifying forms, consult sources in this order: + +1. **Primary (always first):** + - https://smarkform.bitifet.net/resources/AGENTS/SmarkForm-Forms + - https://smarkform.bitifet.net/resources/AGENTS/SmarkForm-Usage +2. **Fallback (repo source of canonical pages):** + - `docs/_resources/AGENTS/SmarkForm-Forms.md` + - `docs/_resources/AGENTS/SmarkForm-Usage.md` +3. **Last fallback (repo pointers):** + - `AGENTS/SmarkForm-Forms.md` + - `AGENTS/SmarkForm-Usage.md` + +If sources disagree, prefer the highest-priority source. + +## Required Rules (hard requirements) + +1. **Event/action integration** + - Use SmarkForm actions and SmarkForm events (`BeforeAction_*` / `AfterAction_*`) for form workflows. + - Do not replace SmarkForm action flows with arbitrary ad-hoc DOM listeners on managed form controls. +2. **Render timing** + - Always wait for `await myForm.rendered` before any `find()` usage or component-tree-dependent logic. +3. **List/template/context semantics** + - Follow list template role rules (`item`, `empty_list`, `header`, `footer`, etc.). + - Respect context/target resolution semantics for triggers. + - For controls inside cloned item templates that target sub-lists, use safe placement patterns documented in SmarkForm Usage. +4. **Security/root options** + - Security-sensitive options must be configured on the root SmarkForm constructor options (not via nested `data-smark` inheritance tricks). + - Keep secure defaults unless explicit requirement justifies opt-in. +5. **Naming convention in examples** + - Use `myForm` as the SmarkForm instance variable in generated JS examples. + +## Standard Implementation Workflow + +1. Read primary source pages. +2. Draft HTML with `data-smark` attributes on all managed fields. +3. Initialize with: + - `const myForm = new SmarkForm(document.getElementById("myForm"), options);` + - `await myForm.rendered;` +4. Wire behavior through SmarkForm actions/events. +5. Validate against the compliance checklist below. + +## Output Contract + +Every response that delivers SmarkForm code must include: + +1. The implementation. +2. A **SmarkForm compliance checklist** section showing pass/fail for each item. + +If any checklist item fails, the skill must treat output as incomplete and revise it before finalizing. + +## SmarkForm Compliance Checklist (mandatory) + +- [ ] Managed fields include `data-smark`. +- [ ] Root element is passed to `new SmarkForm(...)` correctly. +- [ ] Uses `myForm` variable naming convention. +- [ ] `await myForm.rendered` before `find()` and component-dependent logic. +- [ ] Uses SmarkForm actions/events for form workflows (`BeforeAction_*` / `AfterAction_*`) where applicable. +- [ ] List template roles and placement rules are respected. +- [ ] `context` / `target` paths follow SmarkForm rules. +- [ ] No conflicting dual defaults (`value=""` plus JSON `"value"` on same element). +- [ ] Security-sensitive options are set at root constructor options when needed. +- [ ] Production CDN examples are version-pinned (if CDN is used). + +## Distribution Notes + +- This file is the canonical core skill artifact in-repo. +- For external tools (opencode, similar), adapt this spec to tool-specific front matter/format without changing behavioral rules. From abf195794a80e70d7895e968a0f3e23ca0457768 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Thu, 7 May 2026 11:12:22 +0000 Subject: [PATCH 2/7] chore: address review feedback on skill/docs consistency Agent-Logs-Url: https://github.com/bitifet/SmarkForm/sessions/9b4bdf31-cf26-44d5-b4c3-1d3eebf2caf0 Co-authored-by: bitifet <1643647+bitifet@users.noreply.github.com> --- docs/_resources/ai-agents.md | 16 ++++++++-------- skills/SmarkForm-Advanced-Internals.skill.md | 11 +++++------ 2 files changed, 13 insertions(+), 14 deletions(-) diff --git a/docs/_resources/ai-agents.md b/docs/_resources/ai-agents.md index 0ac30dae..e35a03a4 100644 --- a/docs/_resources/ai-agents.md +++ b/docs/_resources/ai-agents.md @@ -16,17 +16,17 @@ nav_order: 6 * [Agent Knowledge Files](#agent-knowledge-files) - * [How to Use These Files When Prompting an AI](#how-to-use-these-files-when-prompting-an-ai) - * [Quick Reference Prompts](#quick-reference-prompts) +* [How to Use These Files When Prompting an AI](#how-to-use-these-files-when-prompting-an-ai) + * [Quick Reference Prompts](#quick-reference-prompts) * [Installable Skills](#installable-skills) - * [Core Skill (recommended)](#core-skill-recommended) - * [Optional Advanced Skill](#optional-advanced-skill) - * [Import into opencode or similar tools](#import-into-opencode-or-similar-tools) + * [Core Skill (recommended)](#core-skill-recommended) + * [Optional Advanced Skill](#optional-advanced-skill) + * [Import into opencode or similar tools](#import-into-opencode-or-similar-tools) * [Maintenance Rules for Skill Files](#maintenance-rules-for-skill-files) * [Prompt Templates](#prompt-templates) - * [Simple form](#simple-form) - * [Form with a repeating list](#form-with-a-repeating-list) - * [Adding SmarkForm to an existing page](#adding-smarkform-to-an-existing-page) + * [Simple form](#simple-form) + * [Form with a repeating list](#form-with-a-repeating-list) + * [Adding SmarkForm to an existing page](#adding-smarkform-to-an-existing-page) " | markdownify }} diff --git a/skills/SmarkForm-Advanced-Internals.skill.md b/skills/SmarkForm-Advanced-Internals.skill.md index 2d2be06b..7365c165 100644 --- a/skills/SmarkForm-Advanced-Internals.skill.md +++ b/skills/SmarkForm-Advanced-Internals.skill.md @@ -17,12 +17,11 @@ For standard form implementation, use: ## Source Priority -1. https://smarkform.bitifet.net/resources/AGENTS/SmarkForm-Usage -2. https://smarkform.bitifet.net/resources/AGENTS/SmarkForm-Forms -3. `docs/_resources/AGENTS/SmarkForm-Usage.md` -4. `docs/_resources/AGENTS/SmarkForm-Forms.md` -5. `AGENTS/SmarkForm-Usage.md` -6. `AGENTS/SmarkForm-Forms.md` +Use the exact source-priority order defined in: +- `skills/SmarkForm-Form-Builder.skill.md` + +Additionally, for internals-first tasks, start by reading: +- https://smarkform.bitifet.net/resources/AGENTS/SmarkForm-Usage ## Non-negotiable Internals Rules From b4deca8d0e40ff1cf31684ea98a20ea6e1f6dd19 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Thu, 7 May 2026 11:13:14 +0000 Subject: [PATCH 3/7] docs: clarify compliance checklist behavior and skill maintenance triggers Agent-Logs-Url: https://github.com/bitifet/SmarkForm/sessions/9b4bdf31-cf26-44d5-b4c3-1d3eebf2caf0 Co-authored-by: bitifet <1643647+bitifet@users.noreply.github.com> --- docs/_resources/ai-agents.md | 3 +++ skills/SmarkForm-Form-Builder.skill.md | 3 +++ 2 files changed, 6 insertions(+) diff --git a/docs/_resources/ai-agents.md b/docs/_resources/ai-agents.md index e35a03a4..c924fc51 100644 --- a/docs/_resources/ai-agents.md +++ b/docs/_resources/ai-agents.md @@ -108,6 +108,9 @@ Use this when handling advanced internals and edge cases. - When `docs/_resources/AGENTS/SmarkForm-Forms.md` or `docs/_resources/AGENTS/SmarkForm-Usage.md` changes, update the relevant files under `skills/` in the same PR. +- Apply the same update rule when their deployed equivalents change: + `https://smarkform.bitifet.net/resources/AGENTS/SmarkForm-Forms` and + `https://smarkform.bitifet.net/resources/AGENTS/SmarkForm-Usage`. - Keep the source-priority order intact so deployed docs remain the primary knowledge source for agents. - If behavioral rules change, update both the skill file(s) and this page. diff --git a/skills/SmarkForm-Form-Builder.skill.md b/skills/SmarkForm-Form-Builder.skill.md index 9e547526..7fbbd1c4 100644 --- a/skills/SmarkForm-Form-Builder.skill.md +++ b/skills/SmarkForm-Form-Builder.skill.md @@ -58,6 +58,9 @@ If any checklist item fails, the skill must treat output as incomplete and revis ## SmarkForm Compliance Checklist (mandatory) +When generating output, evaluate each item and report explicit pass/fail status; +do not leave this as an unchecked template list. + - [ ] Managed fields include `data-smark`. - [ ] Root element is passed to `new SmarkForm(...)` correctly. - [ ] Uses `myForm` variable naming convention. From d650a3995cbe54f335facd52f59bd9c7bc4d8a5b Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Thu, 7 May 2026 11:14:11 +0000 Subject: [PATCH 4/7] docs: tighten skill checklist pass-fail wording Agent-Logs-Url: https://github.com/bitifet/SmarkForm/sessions/9b4bdf31-cf26-44d5-b4c3-1d3eebf2caf0 Co-authored-by: bitifet <1643647+bitifet@users.noreply.github.com> --- skills/SmarkForm-Form-Builder.skill.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/skills/SmarkForm-Form-Builder.skill.md b/skills/SmarkForm-Form-Builder.skill.md index 7fbbd1c4..635cd4d6 100644 --- a/skills/SmarkForm-Form-Builder.skill.md +++ b/skills/SmarkForm-Form-Builder.skill.md @@ -55,11 +55,15 @@ Every response that delivers SmarkForm code must include: 2. A **SmarkForm compliance checklist** section showing pass/fail for each item. If any checklist item fails, the skill must treat output as incomplete and revise it before finalizing. +If tool limitations prevent revision, explicitly report unmet items and why. ## SmarkForm Compliance Checklist (mandatory) -When generating output, evaluate each item and report explicit pass/fail status; -do not leave this as an unchecked template list. +When generating output, evaluate each item and report explicit pass/fail status. +Replace template markers with: +- `[x]` for pass +- `[ ]` for fail +Do not leave this section as an untouched unchecked template. - [ ] Managed fields include `data-smark`. - [ ] Root element is passed to `new SmarkForm(...)` correctly. From a06018c5a8a616443a0bb1f16a26b3f629b1ea52 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Thu, 7 May 2026 11:15:20 +0000 Subject: [PATCH 5/7] docs: clarify skill maintenance scope and compliance wording Agent-Logs-Url: https://github.com/bitifet/SmarkForm/sessions/9b4bdf31-cf26-44d5-b4c3-1d3eebf2caf0 Co-authored-by: bitifet <1643647+bitifet@users.noreply.github.com> --- AGENTS.md | 6 +++--- docs/_resources/ai-agents.md | 4 ++-- skills/SmarkForm-Form-Builder.skill.md | 8 +++++--- 3 files changed, 10 insertions(+), 8 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 31062d93..b010963c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -374,9 +374,9 @@ implementation behavior. Maintenance rule: - When `docs/_resources/AGENTS/SmarkForm-Forms.md` or - `docs/_resources/AGENTS/SmarkForm-Usage.md` changes, update affected files in - `skills/` in the same PR so installable skills stay aligned with canonical - docs. + `docs/_resources/AGENTS/SmarkForm-Usage.md` changes, review and update both + skill files in `skills/` if affected; when in doubt, update both in the same + PR so installable skills stay aligned with canonical docs. - **Contributing**: See `CONTRIBUTING.md` diff --git a/docs/_resources/ai-agents.md b/docs/_resources/ai-agents.md index c924fc51..f2b0f5a0 100644 --- a/docs/_resources/ai-agents.md +++ b/docs/_resources/ai-agents.md @@ -106,8 +106,8 @@ Use this when handling advanced internals and edge cases. ## Maintenance Rules for Skill Files - When `docs/_resources/AGENTS/SmarkForm-Forms.md` or - `docs/_resources/AGENTS/SmarkForm-Usage.md` changes, update the relevant - files under `skills/` in the same PR. + `docs/_resources/AGENTS/SmarkForm-Usage.md` changes, review and update both + files under `skills/` if affected; when in doubt, update both in the same PR. - Apply the same update rule when their deployed equivalents change: `https://smarkform.bitifet.net/resources/AGENTS/SmarkForm-Forms` and `https://smarkform.bitifet.net/resources/AGENTS/SmarkForm-Usage`. diff --git a/skills/SmarkForm-Form-Builder.skill.md b/skills/SmarkForm-Form-Builder.skill.md index 635cd4d6..2f4a2404 100644 --- a/skills/SmarkForm-Form-Builder.skill.md +++ b/skills/SmarkForm-Form-Builder.skill.md @@ -54,8 +54,9 @@ Every response that delivers SmarkForm code must include: 1. The implementation. 2. A **SmarkForm compliance checklist** section showing pass/fail for each item. -If any checklist item fails, the skill must treat output as incomplete and revise it before finalizing. -If tool limitations prevent revision, explicitly report unmet items and why. +If any checklist item fails, the skill must treat output as incomplete and revise +it before finalizing. If revision is not possible, add a clear warning header +(`SmarkForm compliance incomplete`) and explicitly report unmet items and why. ## SmarkForm Compliance Checklist (mandatory) @@ -74,7 +75,8 @@ Do not leave this section as an untouched unchecked template. - [ ] `context` / `target` paths follow SmarkForm rules. - [ ] No conflicting dual defaults (`value=""` plus JSON `"value"` on same element). - [ ] Security-sensitive options are set at root constructor options when needed. -- [ ] Production CDN examples are version-pinned (if CDN is used). +- [ ] Production CDN examples use explicit version numbers (for example + `@0.16.0`) and do not use `@latest`. ## Distribution Notes From cb585f8c55b046c85716a1eb21efda8eff7bd7f8 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Thu, 7 May 2026 11:16:51 +0000 Subject: [PATCH 6/7] docs: remove remaining ambiguity in skill checklist and maintenance rules Agent-Logs-Url: https://github.com/bitifet/SmarkForm/sessions/9b4bdf31-cf26-44d5-b4c3-1d3eebf2caf0 Co-authored-by: bitifet <1643647+bitifet@users.noreply.github.com> --- docs/_resources/ai-agents.md | 4 +++- skills/SmarkForm-Form-Builder.skill.md | 3 +++ 2 files changed, 6 insertions(+), 1 deletion(-) diff --git a/docs/_resources/ai-agents.md b/docs/_resources/ai-agents.md index f2b0f5a0..9a08fdd1 100644 --- a/docs/_resources/ai-agents.md +++ b/docs/_resources/ai-agents.md @@ -107,7 +107,9 @@ Use this when handling advanced internals and edge cases. - When `docs/_resources/AGENTS/SmarkForm-Forms.md` or `docs/_resources/AGENTS/SmarkForm-Usage.md` changes, review and update both - files under `skills/` if affected; when in doubt, update both in the same PR. + `skills/SmarkForm-Form-Builder.skill.md` and + `skills/SmarkForm-Advanced-Internals.skill.md` if affected; when in doubt, + update both in the same PR. - Apply the same update rule when their deployed equivalents change: `https://smarkform.bitifet.net/resources/AGENTS/SmarkForm-Forms` and `https://smarkform.bitifet.net/resources/AGENTS/SmarkForm-Usage`. diff --git a/skills/SmarkForm-Form-Builder.skill.md b/skills/SmarkForm-Form-Builder.skill.md index 2f4a2404..8be5cd6e 100644 --- a/skills/SmarkForm-Form-Builder.skill.md +++ b/skills/SmarkForm-Form-Builder.skill.md @@ -60,6 +60,9 @@ it before finalizing. If revision is not possible, add a clear warning header ## SmarkForm Compliance Checklist (mandatory) +Template below is intentionally unchecked in this skill spec. In generated +outputs, agents must replace it with explicit pass/fail marks per item. + When generating output, evaluate each item and report explicit pass/fail status. Replace template markers with: - `[x]` for pass From 4eb728dfb5249a72ad89292290ae59d8eccd064a Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Thu, 7 May 2026 11:18:00 +0000 Subject: [PATCH 7/7] docs: normalize markdown continuation formatting in skill guidance Agent-Logs-Url: https://github.com/bitifet/SmarkForm/sessions/9b4bdf31-cf26-44d5-b4c3-1d3eebf2caf0 Co-authored-by: bitifet <1643647+bitifet@users.noreply.github.com> --- AGENTS.md | 5 +---- docs/_resources/ai-agents.md | 6 +----- skills/SmarkForm-Form-Builder.skill.md | 3 +-- 3 files changed, 3 insertions(+), 11 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index b010963c..ec7e3f68 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -373,10 +373,7 @@ implementation behavior. | `skills/SmarkForm-Advanced-Internals.skill.md` | Optional advanced skill for internals-heavy work (action semantics, list/context edge cases, security-sensitive patterns) | Maintenance rule: -- When `docs/_resources/AGENTS/SmarkForm-Forms.md` or - `docs/_resources/AGENTS/SmarkForm-Usage.md` changes, review and update both - skill files in `skills/` if affected; when in doubt, update both in the same - PR so installable skills stay aligned with canonical docs. +- When `docs/_resources/AGENTS/SmarkForm-Forms.md` or `docs/_resources/AGENTS/SmarkForm-Usage.md` changes, review and update both skill files in `skills/` if affected; when in doubt, update both in the same PR so installable skills stay aligned with canonical docs. - **Contributing**: See `CONTRIBUTING.md` diff --git a/docs/_resources/ai-agents.md b/docs/_resources/ai-agents.md index 9a08fdd1..eeeb5846 100644 --- a/docs/_resources/ai-agents.md +++ b/docs/_resources/ai-agents.md @@ -105,11 +105,7 @@ Use this when handling advanced internals and edge cases. ## Maintenance Rules for Skill Files -- When `docs/_resources/AGENTS/SmarkForm-Forms.md` or - `docs/_resources/AGENTS/SmarkForm-Usage.md` changes, review and update both - `skills/SmarkForm-Form-Builder.skill.md` and - `skills/SmarkForm-Advanced-Internals.skill.md` if affected; when in doubt, - update both in the same PR. +- When `docs/_resources/AGENTS/SmarkForm-Forms.md` or `docs/_resources/AGENTS/SmarkForm-Usage.md` changes, review and update both `skills/SmarkForm-Form-Builder.skill.md` and `skills/SmarkForm-Advanced-Internals.skill.md` if affected; when in doubt, update both in the same PR. - Apply the same update rule when their deployed equivalents change: `https://smarkform.bitifet.net/resources/AGENTS/SmarkForm-Forms` and `https://smarkform.bitifet.net/resources/AGENTS/SmarkForm-Usage`. diff --git a/skills/SmarkForm-Form-Builder.skill.md b/skills/SmarkForm-Form-Builder.skill.md index 8be5cd6e..4d8a034c 100644 --- a/skills/SmarkForm-Form-Builder.skill.md +++ b/skills/SmarkForm-Form-Builder.skill.md @@ -78,8 +78,7 @@ Do not leave this section as an untouched unchecked template. - [ ] `context` / `target` paths follow SmarkForm rules. - [ ] No conflicting dual defaults (`value=""` plus JSON `"value"` on same element). - [ ] Security-sensitive options are set at root constructor options when needed. -- [ ] Production CDN examples use explicit version numbers (for example - `@0.16.0`) and do not use `@latest`. +- [ ] Production CDN examples use explicit version numbers (for example `@0.16.0`) and do not use `@latest`. ## Distribution Notes