From 6f4c297fc98f805bcbdbd3ef3250415281ac43a6 Mon Sep 17 00:00:00 2001 From: Keming He Date: Mon, 1 Jun 2026 13:39:46 -0400 Subject: [PATCH 1/3] fix(gdc): add Unicode box drawing exception to Characters constraint CHANGES - Add box drawing characters as named exception for tree-style directory rendering - Pluralize "Exception" to "Exceptions" to accommodate multiple entries - Bump canonical GDC from v1.1.1 to v1.2.0 SCOPE - Canonical source: skill-creation/assets/general-doc-constraints.md - Host skill embed: skill-creation/SKILL.md - Remaining 11 embeds propagated in follow-up commit --- .agents/skills/skill-creation/SKILL.md | 4 ++-- .../skills/skill-creation/assets/general-doc-constraints.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/.agents/skills/skill-creation/SKILL.md b/.agents/skills/skill-creation/SKILL.md index a2b9ba5..a3f9ef2 100644 --- a/.agents/skills/skill-creation/SKILL.md +++ b/.agents/skills/skill-creation/SKILL.md @@ -135,7 +135,7 @@ Present each file in a markdown code block with the filename as header. Apply to all generated output. If a discovered template deviates from any rule (e.g., uses emojis semantically, uses a different bullet convention), note the deviation explicitly and confirm with the user before treating it as a permitted exception. -- **Characters**: QWERTY keyboard typeable only - no smart quotes, emojis, or special Unicode anywhere. In prose, do not use em-dashes or em-dash substitutes (`--`, ` -- `); use ` - ` (space-dash-space) for clause separation instead. Exception: `↑` for ToC navigation. +- **Characters**: QWERTY keyboard typeable only - no smart quotes, emojis, or special Unicode anywhere. In prose, do not use em-dashes or em-dash substitutes (`--`, ` -- `); use ` - ` (space-dash-space) for clause separation instead. Exceptions: `↑` for ToC navigation; Unicode box drawing characters for `tree`-style directory rendering. - **Inline formatting**: Use `_underscore_` for italics, not `*single-star*`. Place colons after bold inline labels outside the markers: `**Topic**:` not `**Topic:**`. - **Bullets**: Use `-` for all unordered lists; one bullet per complete thought; never wrap a bullet's content mid-sentence onto a continuation line - split into separate bullets if too long or multi-thought. Nested sub-bullets for component grouping are permitted. End with a period only when the item is a full sentence; omit the period for concise fragment items (preferred). - **Prose**: Do not insert hard newlines to simulate visual wrapping. Keep each prose paragraph on one continuous physical line and let editors or viewers wrap it visually. Exception: commit message bodies use one sentence per line for `git log` readability. @@ -143,7 +143,7 @@ Apply to all generated output. If a discovered template deviates from any rule ( - **Consistency**: Use the same term for the same concept throughout; match the voice and tense of the template; do not mix header levels for parallel sections. - **KISS and DRY**: Each section and bullet conveys unique information - no redundancy or overlap. -> General Doc Constraints v1.1.1 - KemingHe/common-devx +> General Doc Constraints v1.2.0 - KemingHe/common-devx ## Skill Constraints diff --git a/.agents/skills/skill-creation/assets/general-doc-constraints.md b/.agents/skills/skill-creation/assets/general-doc-constraints.md index a17fa73..9979877 100644 --- a/.agents/skills/skill-creation/assets/general-doc-constraints.md +++ b/.agents/skills/skill-creation/assets/general-doc-constraints.md @@ -2,7 +2,7 @@ Apply to all generated output. If a discovered template deviates from any rule (e.g., uses emojis semantically, uses a different bullet convention), note the deviation explicitly and confirm with the user before treating it as a permitted exception. -- **Characters**: QWERTY keyboard typeable only - no smart quotes, emojis, or special Unicode anywhere. In prose, do not use em-dashes or em-dash substitutes (`--`, ` -- `); use ` - ` (space-dash-space) for clause separation instead. Exception: `↑` for ToC navigation. +- **Characters**: QWERTY keyboard typeable only - no smart quotes, emojis, or special Unicode anywhere. In prose, do not use em-dashes or em-dash substitutes (`--`, ` -- `); use ` - ` (space-dash-space) for clause separation instead. Exceptions: `↑` for ToC navigation; Unicode box drawing characters for `tree`-style directory rendering. - **Inline formatting**: Use `_underscore_` for italics, not `*single-star*`. Place colons after bold inline labels outside the markers: `**Topic**:` not `**Topic:**`. - **Bullets**: Use `-` for all unordered lists; one bullet per complete thought; never wrap a bullet's content mid-sentence onto a continuation line - split into separate bullets if too long or multi-thought. Nested sub-bullets for component grouping are permitted. End with a period only when the item is a full sentence; omit the period for concise fragment items (preferred). - **Prose**: Do not insert hard newlines to simulate visual wrapping. Keep each prose paragraph on one continuous physical line and let editors or viewers wrap it visually. Exception: commit message bodies use one sentence per line for `git log` readability. @@ -10,4 +10,4 @@ Apply to all generated output. If a discovered template deviates from any rule ( - **Consistency**: Use the same term for the same concept throughout; match the voice and tense of the template; do not mix header levels for parallel sections. - **KISS and DRY**: Each section and bullet conveys unique information - no redundancy or overlap. -> General Doc Constraints v1.1.1 - KemingHe/common-devx +> General Doc Constraints v1.2.0 - KemingHe/common-devx From 4e1904208da773b9d1835a0bc26598804f2a44a6 Mon Sep 17 00:00:00 2001 From: Keming He Date: Mon, 1 Jun 2026 13:44:50 -0400 Subject: [PATCH 2/3] fix(gdc): propagate v1.2.0 box drawing exception to all skill embeds closes #99 CHANGES - Update Characters constraint and version footer in 11 remaining SKILL.md files - All 13 GDC embed locations now consistent at v1.2.0 --- .agents/skills/commit-message-creation/SKILL.md | 4 ++-- .agents/skills/contacts-management/SKILL.md | 4 ++-- .agents/skills/documentation-review/SKILL.md | 4 ++-- .agents/skills/dot-gitlab-sync/SKILL.md | 4 ++-- .agents/skills/issue-creation/SKILL.md | 4 ++-- .agents/skills/living-design-documents/SKILL.md | 4 ++-- .agents/skills/meeting-agenda-creation/SKILL.md | 4 ++-- .agents/skills/meeting-memo-creation/SKILL.md | 4 ++-- .agents/skills/next-session-handoff/SKILL.md | 4 ++-- .agents/skills/pull-merge-request-creation/SKILL.md | 4 ++-- .agents/skills/readme-creation/SKILL.md | 4 ++-- 11 files changed, 22 insertions(+), 22 deletions(-) diff --git a/.agents/skills/commit-message-creation/SKILL.md b/.agents/skills/commit-message-creation/SKILL.md index 2859ee3..22469d2 100644 --- a/.agents/skills/commit-message-creation/SKILL.md +++ b/.agents/skills/commit-message-creation/SKILL.md @@ -160,7 +160,7 @@ type(scope): brief description in imperative mood Apply to all generated output. If a discovered template deviates from any rule (e.g., uses emojis semantically, uses a different bullet convention), note the deviation explicitly and confirm with the user before treating it as a permitted exception. -- **Characters**: QWERTY keyboard typeable only - no smart quotes, emojis, or special Unicode anywhere. In prose, do not use em-dashes or em-dash substitutes (`--`, ` -- `); use ` - ` (space-dash-space) for clause separation instead. Exception: `↑` for ToC navigation. +- **Characters**: QWERTY keyboard typeable only - no smart quotes, emojis, or special Unicode anywhere. In prose, do not use em-dashes or em-dash substitutes (`--`, ` -- `); use ` - ` (space-dash-space) for clause separation instead. Exceptions: `↑` for ToC navigation; Unicode box drawing characters for `tree`-style directory rendering. - **Inline formatting**: Use `_underscore_` for italics, not `*single-star*`. Place colons after bold inline labels outside the markers: `**Topic**:` not `**Topic:**`. - **Bullets**: Use `-` for all unordered lists; one bullet per complete thought; never wrap a bullet's content mid-sentence onto a continuation line - split into separate bullets if too long or multi-thought. Nested sub-bullets for component grouping are permitted. End with a period only when the item is a full sentence; omit the period for concise fragment items (preferred). - **Prose**: Do not insert hard newlines to simulate visual wrapping. Keep each prose paragraph on one continuous physical line and let editors or viewers wrap it visually. Exception: commit message bodies use one sentence per line for `git log` readability. @@ -168,7 +168,7 @@ Apply to all generated output. If a discovered template deviates from any rule ( - **Consistency**: Use the same term for the same concept throughout; match the voice and tense of the template; do not mix header levels for parallel sections. - **KISS and DRY**: Each section and bullet conveys unique information - no redundancy or overlap. -> General Doc Constraints v1.1.1 - KemingHe/common-devx +> General Doc Constraints v1.2.0 - KemingHe/common-devx ## Skill Constraints diff --git a/.agents/skills/contacts-management/SKILL.md b/.agents/skills/contacts-management/SKILL.md index a93ac30..4398f5d 100644 --- a/.agents/skills/contacts-management/SKILL.md +++ b/.agents/skills/contacts-management/SKILL.md @@ -142,7 +142,7 @@ Present contact entry in markdown following template structure: Apply to all generated output. If a discovered template deviates from any rule (e.g., uses emojis semantically, uses a different bullet convention), note the deviation explicitly and confirm with the user before treating it as a permitted exception. -- **Characters**: QWERTY keyboard typeable only - no smart quotes, emojis, or special Unicode anywhere. In prose, do not use em-dashes or em-dash substitutes (`--`, ` -- `); use ` - ` (space-dash-space) for clause separation instead. Exception: `↑` for ToC navigation. +- **Characters**: QWERTY keyboard typeable only - no smart quotes, emojis, or special Unicode anywhere. In prose, do not use em-dashes or em-dash substitutes (`--`, ` -- `); use ` - ` (space-dash-space) for clause separation instead. Exceptions: `↑` for ToC navigation; Unicode box drawing characters for `tree`-style directory rendering. - **Inline formatting**: Use `_underscore_` for italics, not `*single-star*`. Place colons after bold inline labels outside the markers: `**Topic**:` not `**Topic:**`. - **Bullets**: Use `-` for all unordered lists; one bullet per complete thought; never wrap a bullet's content mid-sentence onto a continuation line - split into separate bullets if too long or multi-thought. Nested sub-bullets for component grouping are permitted. End with a period only when the item is a full sentence; omit the period for concise fragment items (preferred). - **Prose**: Do not insert hard newlines to simulate visual wrapping. Keep each prose paragraph on one continuous physical line and let editors or viewers wrap it visually. Exception: commit message bodies use one sentence per line for `git log` readability. @@ -150,7 +150,7 @@ Apply to all generated output. If a discovered template deviates from any rule ( - **Consistency**: Use the same term for the same concept throughout; match the voice and tense of the template; do not mix header levels for parallel sections. - **KISS and DRY**: Each section and bullet conveys unique information - no redundancy or overlap. -> General Doc Constraints v1.1.1 - KemingHe/common-devx +> General Doc Constraints v1.2.0 - KemingHe/common-devx ## Skill Constraints diff --git a/.agents/skills/documentation-review/SKILL.md b/.agents/skills/documentation-review/SKILL.md index 03ecb4d..5544c07 100644 --- a/.agents/skills/documentation-review/SKILL.md +++ b/.agents/skills/documentation-review/SKILL.md @@ -88,7 +88,7 @@ Summarize with: Apply to all generated output. If a discovered template deviates from any rule (e.g., uses emojis semantically, uses a different bullet convention), note the deviation explicitly and confirm with the user before treating it as a permitted exception. -- **Characters**: QWERTY keyboard typeable only - no smart quotes, emojis, or special Unicode anywhere. In prose, do not use em-dashes or em-dash substitutes (`--`, ` -- `); use ` - ` (space-dash-space) for clause separation instead. Exception: `↑` for ToC navigation. +- **Characters**: QWERTY keyboard typeable only - no smart quotes, emojis, or special Unicode anywhere. In prose, do not use em-dashes or em-dash substitutes (`--`, ` -- `); use ` - ` (space-dash-space) for clause separation instead. Exceptions: `↑` for ToC navigation; Unicode box drawing characters for `tree`-style directory rendering. - **Inline formatting**: Use `_underscore_` for italics, not `*single-star*`. Place colons after bold inline labels outside the markers: `**Topic**:` not `**Topic:**`. - **Bullets**: Use `-` for all unordered lists; one bullet per complete thought; never wrap a bullet's content mid-sentence onto a continuation line - split into separate bullets if too long or multi-thought. Nested sub-bullets for component grouping are permitted. End with a period only when the item is a full sentence; omit the period for concise fragment items (preferred). - **Prose**: Do not insert hard newlines to simulate visual wrapping. Keep each prose paragraph on one continuous physical line and let editors or viewers wrap it visually. Exception: commit message bodies use one sentence per line for `git log` readability. @@ -96,7 +96,7 @@ Apply to all generated output. If a discovered template deviates from any rule ( - **Consistency**: Use the same term for the same concept throughout; match the voice and tense of the template; do not mix header levels for parallel sections. - **KISS and DRY**: Each section and bullet conveys unique information - no redundancy or overlap. -> General Doc Constraints v1.1.1 - KemingHe/common-devx +> General Doc Constraints v1.2.0 - KemingHe/common-devx ## Skill Constraints diff --git a/.agents/skills/dot-gitlab-sync/SKILL.md b/.agents/skills/dot-gitlab-sync/SKILL.md index 9d6c5c9..0319fca 100644 --- a/.agents/skills/dot-gitlab-sync/SKILL.md +++ b/.agents/skills/dot-gitlab-sync/SKILL.md @@ -83,7 +83,7 @@ Report clean status or list remaining discrepancies. Apply to all generated output. If a discovered template deviates from any rule (e.g., uses emojis semantically, uses a different bullet convention), note the deviation explicitly and confirm with the user before treating it as a permitted exception. -- **Characters**: QWERTY keyboard typeable only - no smart quotes, emojis, or special Unicode anywhere. In prose, do not use em-dashes or em-dash substitutes (`--`, ` -- `); use ` - ` (space-dash-space) for clause separation instead. Exception: `↑` for ToC navigation. +- **Characters**: QWERTY keyboard typeable only - no smart quotes, emojis, or special Unicode anywhere. In prose, do not use em-dashes or em-dash substitutes (`--`, ` -- `); use ` - ` (space-dash-space) for clause separation instead. Exceptions: `↑` for ToC navigation; Unicode box drawing characters for `tree`-style directory rendering. - **Inline formatting**: Use `_underscore_` for italics, not `*single-star*`. Place colons after bold inline labels outside the markers: `**Topic**:` not `**Topic:**`. - **Bullets**: Use `-` for all unordered lists; one bullet per complete thought; never wrap a bullet's content mid-sentence onto a continuation line - split into separate bullets if too long or multi-thought. Nested sub-bullets for component grouping are permitted. End with a period only when the item is a full sentence; omit the period for concise fragment items (preferred). - **Prose**: Do not insert hard newlines to simulate visual wrapping. Keep each prose paragraph on one continuous physical line and let editors or viewers wrap it visually. Exception: commit message bodies use one sentence per line for `git log` readability. @@ -91,7 +91,7 @@ Apply to all generated output. If a discovered template deviates from any rule ( - **Consistency**: Use the same term for the same concept throughout; match the voice and tense of the template; do not mix header levels for parallel sections. - **KISS and DRY**: Each section and bullet conveys unique information - no redundancy or overlap. -> General Doc Constraints v1.1.1 - KemingHe/common-devx +> General Doc Constraints v1.2.0 - KemingHe/common-devx ## Skill Constraints diff --git a/.agents/skills/issue-creation/SKILL.md b/.agents/skills/issue-creation/SKILL.md index edea8b0..4ec730d 100644 --- a/.agents/skills/issue-creation/SKILL.md +++ b/.agents/skills/issue-creation/SKILL.md @@ -142,7 +142,7 @@ feat(component): brief description Apply to all generated output. If a discovered template deviates from any rule (e.g., uses emojis semantically, uses a different bullet convention), note the deviation explicitly and confirm with the user before treating it as a permitted exception. -- **Characters**: QWERTY keyboard typeable only - no smart quotes, emojis, or special Unicode anywhere. In prose, do not use em-dashes or em-dash substitutes (`--`, ` -- `); use ` - ` (space-dash-space) for clause separation instead. Exception: `↑` for ToC navigation. +- **Characters**: QWERTY keyboard typeable only - no smart quotes, emojis, or special Unicode anywhere. In prose, do not use em-dashes or em-dash substitutes (`--`, ` -- `); use ` - ` (space-dash-space) for clause separation instead. Exceptions: `↑` for ToC navigation; Unicode box drawing characters for `tree`-style directory rendering. - **Inline formatting**: Use `_underscore_` for italics, not `*single-star*`. Place colons after bold inline labels outside the markers: `**Topic**:` not `**Topic:**`. - **Bullets**: Use `-` for all unordered lists; one bullet per complete thought; never wrap a bullet's content mid-sentence onto a continuation line - split into separate bullets if too long or multi-thought. Nested sub-bullets for component grouping are permitted. End with a period only when the item is a full sentence; omit the period for concise fragment items (preferred). - **Prose**: Do not insert hard newlines to simulate visual wrapping. Keep each prose paragraph on one continuous physical line and let editors or viewers wrap it visually. Exception: commit message bodies use one sentence per line for `git log` readability. @@ -150,7 +150,7 @@ Apply to all generated output. If a discovered template deviates from any rule ( - **Consistency**: Use the same term for the same concept throughout; match the voice and tense of the template; do not mix header levels for parallel sections. - **KISS and DRY**: Each section and bullet conveys unique information - no redundancy or overlap. -> General Doc Constraints v1.1.1 - KemingHe/common-devx +> General Doc Constraints v1.2.0 - KemingHe/common-devx ## Skill Constraints diff --git a/.agents/skills/living-design-documents/SKILL.md b/.agents/skills/living-design-documents/SKILL.md index 459f0f7..118f45e 100644 --- a/.agents/skills/living-design-documents/SKILL.md +++ b/.agents/skills/living-design-documents/SKILL.md @@ -198,7 +198,7 @@ Present all generated or updated design documents as complete markdown code bloc Apply to all generated output. If a discovered template deviates from any rule (e.g., uses emojis semantically, uses a different bullet convention), note the deviation explicitly and confirm with the user before treating it as a permitted exception. -- **Characters**: QWERTY keyboard typeable only - no smart quotes, emojis, or special Unicode anywhere. In prose, do not use em-dashes or em-dash substitutes (`--`, ` -- `); use ` - ` (space-dash-space) for clause separation instead. Exception: `↑` for ToC navigation. +- **Characters**: QWERTY keyboard typeable only - no smart quotes, emojis, or special Unicode anywhere. In prose, do not use em-dashes or em-dash substitutes (`--`, ` -- `); use ` - ` (space-dash-space) for clause separation instead. Exceptions: `↑` for ToC navigation; Unicode box drawing characters for `tree`-style directory rendering. - **Inline formatting**: Use `_underscore_` for italics, not `*single-star*`. Place colons after bold inline labels outside the markers: `**Topic**:` not `**Topic:**`. - **Bullets**: Use `-` for all unordered lists; one bullet per complete thought; never wrap a bullet's content mid-sentence onto a continuation line - split into separate bullets if too long or multi-thought. Nested sub-bullets for component grouping are permitted. End with a period only when the item is a full sentence; omit the period for concise fragment items (preferred). - **Prose**: Do not insert hard newlines to simulate visual wrapping. Keep each prose paragraph on one continuous physical line and let editors or viewers wrap it visually. Exception: commit message bodies use one sentence per line for `git log` readability. @@ -206,7 +206,7 @@ Apply to all generated output. If a discovered template deviates from any rule ( - **Consistency**: Use the same term for the same concept throughout; match the voice and tense of the template; do not mix header levels for parallel sections. - **KISS and DRY**: Each section and bullet conveys unique information - no redundancy or overlap. -> General Doc Constraints v1.1.1 - KemingHe/common-devx +> General Doc Constraints v1.2.0 - KemingHe/common-devx ## Skill Constraints diff --git a/.agents/skills/meeting-agenda-creation/SKILL.md b/.agents/skills/meeting-agenda-creation/SKILL.md index 41d1e12..d75a1d3 100644 --- a/.agents/skills/meeting-agenda-creation/SKILL.md +++ b/.agents/skills/meeting-agenda-creation/SKILL.md @@ -77,7 +77,7 @@ Present agenda in markdown code block following discovered template structure. Apply to all generated output. If a discovered template deviates from any rule (e.g., uses emojis semantically, uses a different bullet convention), note the deviation explicitly and confirm with the user before treating it as a permitted exception. -- **Characters**: QWERTY keyboard typeable only - no smart quotes, emojis, or special Unicode anywhere. In prose, do not use em-dashes or em-dash substitutes (`--`, ` -- `); use ` - ` (space-dash-space) for clause separation instead. Exception: `↑` for ToC navigation. +- **Characters**: QWERTY keyboard typeable only - no smart quotes, emojis, or special Unicode anywhere. In prose, do not use em-dashes or em-dash substitutes (`--`, ` -- `); use ` - ` (space-dash-space) for clause separation instead. Exceptions: `↑` for ToC navigation; Unicode box drawing characters for `tree`-style directory rendering. - **Inline formatting**: Use `_underscore_` for italics, not `*single-star*`. Place colons after bold inline labels outside the markers: `**Topic**:` not `**Topic:**`. - **Bullets**: Use `-` for all unordered lists; one bullet per complete thought; never wrap a bullet's content mid-sentence onto a continuation line - split into separate bullets if too long or multi-thought. Nested sub-bullets for component grouping are permitted. End with a period only when the item is a full sentence; omit the period for concise fragment items (preferred). - **Prose**: Do not insert hard newlines to simulate visual wrapping. Keep each prose paragraph on one continuous physical line and let editors or viewers wrap it visually. Exception: commit message bodies use one sentence per line for `git log` readability. @@ -85,7 +85,7 @@ Apply to all generated output. If a discovered template deviates from any rule ( - **Consistency**: Use the same term for the same concept throughout; match the voice and tense of the template; do not mix header levels for parallel sections. - **KISS and DRY**: Each section and bullet conveys unique information - no redundancy or overlap. -> General Doc Constraints v1.1.1 - KemingHe/common-devx +> General Doc Constraints v1.2.0 - KemingHe/common-devx ## Skill Constraints diff --git a/.agents/skills/meeting-memo-creation/SKILL.md b/.agents/skills/meeting-memo-creation/SKILL.md index ab304a6..5a7ee3d 100644 --- a/.agents/skills/meeting-memo-creation/SKILL.md +++ b/.agents/skills/meeting-memo-creation/SKILL.md @@ -81,7 +81,7 @@ Present memo in markdown code block following discovered template structure. Apply to all generated output. If a discovered template deviates from any rule (e.g., uses emojis semantically, uses a different bullet convention), note the deviation explicitly and confirm with the user before treating it as a permitted exception. -- **Characters**: QWERTY keyboard typeable only - no smart quotes, emojis, or special Unicode anywhere. In prose, do not use em-dashes or em-dash substitutes (`--`, ` -- `); use ` - ` (space-dash-space) for clause separation instead. Exception: `↑` for ToC navigation. +- **Characters**: QWERTY keyboard typeable only - no smart quotes, emojis, or special Unicode anywhere. In prose, do not use em-dashes or em-dash substitutes (`--`, ` -- `); use ` - ` (space-dash-space) for clause separation instead. Exceptions: `↑` for ToC navigation; Unicode box drawing characters for `tree`-style directory rendering. - **Inline formatting**: Use `_underscore_` for italics, not `*single-star*`. Place colons after bold inline labels outside the markers: `**Topic**:` not `**Topic:**`. - **Bullets**: Use `-` for all unordered lists; one bullet per complete thought; never wrap a bullet's content mid-sentence onto a continuation line - split into separate bullets if too long or multi-thought. Nested sub-bullets for component grouping are permitted. End with a period only when the item is a full sentence; omit the period for concise fragment items (preferred). - **Prose**: Do not insert hard newlines to simulate visual wrapping. Keep each prose paragraph on one continuous physical line and let editors or viewers wrap it visually. Exception: commit message bodies use one sentence per line for `git log` readability. @@ -89,7 +89,7 @@ Apply to all generated output. If a discovered template deviates from any rule ( - **Consistency**: Use the same term for the same concept throughout; match the voice and tense of the template; do not mix header levels for parallel sections. - **KISS and DRY**: Each section and bullet conveys unique information - no redundancy or overlap. -> General Doc Constraints v1.1.1 - KemingHe/common-devx +> General Doc Constraints v1.2.0 - KemingHe/common-devx ## Skill Constraints diff --git a/.agents/skills/next-session-handoff/SKILL.md b/.agents/skills/next-session-handoff/SKILL.md index 65320e4..2371b3c 100644 --- a/.agents/skills/next-session-handoff/SKILL.md +++ b/.agents/skills/next-session-handoff/SKILL.md @@ -155,7 +155,7 @@ Present the filled handoff document in a markdown code block. The output is for Apply to all generated output. If a discovered template deviates from any rule (e.g., uses emojis semantically, uses a different bullet convention), note the deviation explicitly and confirm with the user before treating it as a permitted exception. -- **Characters**: QWERTY keyboard typeable only - no smart quotes, emojis, or special Unicode anywhere. In prose, do not use em-dashes or em-dash substitutes (`--`, ` -- `); use ` - ` (space-dash-space) for clause separation instead. Exception: `↑` for ToC navigation. +- **Characters**: QWERTY keyboard typeable only - no smart quotes, emojis, or special Unicode anywhere. In prose, do not use em-dashes or em-dash substitutes (`--`, ` -- `); use ` - ` (space-dash-space) for clause separation instead. Exceptions: `↑` for ToC navigation; Unicode box drawing characters for `tree`-style directory rendering. - **Inline formatting**: Use `_underscore_` for italics, not `*single-star*`. Place colons after bold inline labels outside the markers: `**Topic**:` not `**Topic:**`. - **Bullets**: Use `-` for all unordered lists; one bullet per complete thought; never wrap a bullet's content mid-sentence onto a continuation line - split into separate bullets if too long or multi-thought. Nested sub-bullets for component grouping are permitted. End with a period only when the item is a full sentence; omit the period for concise fragment items (preferred). - **Prose**: Do not insert hard newlines to simulate visual wrapping. Keep each prose paragraph on one continuous physical line and let editors or viewers wrap it visually. Exception: commit message bodies use one sentence per line for `git log` readability. @@ -163,7 +163,7 @@ Apply to all generated output. If a discovered template deviates from any rule ( - **Consistency**: Use the same term for the same concept throughout; match the voice and tense of the template; do not mix header levels for parallel sections. - **KISS and DRY**: Each section and bullet conveys unique information - no redundancy or overlap. -> General Doc Constraints v1.1.1 - KemingHe/common-devx +> General Doc Constraints v1.2.0 - KemingHe/common-devx ## Skill Constraints diff --git a/.agents/skills/pull-merge-request-creation/SKILL.md b/.agents/skills/pull-merge-request-creation/SKILL.md index 20a92dc..f522d99 100644 --- a/.agents/skills/pull-merge-request-creation/SKILL.md +++ b/.agents/skills/pull-merge-request-creation/SKILL.md @@ -174,7 +174,7 @@ type(scope): brief description Apply to all generated output. If a discovered template deviates from any rule (e.g., uses emojis semantically, uses a different bullet convention), note the deviation explicitly and confirm with the user before treating it as a permitted exception. -- **Characters**: QWERTY keyboard typeable only - no smart quotes, emojis, or special Unicode anywhere. In prose, do not use em-dashes or em-dash substitutes (`--`, ` -- `); use ` - ` (space-dash-space) for clause separation instead. Exception: `↑` for ToC navigation. +- **Characters**: QWERTY keyboard typeable only - no smart quotes, emojis, or special Unicode anywhere. In prose, do not use em-dashes or em-dash substitutes (`--`, ` -- `); use ` - ` (space-dash-space) for clause separation instead. Exceptions: `↑` for ToC navigation; Unicode box drawing characters for `tree`-style directory rendering. - **Inline formatting**: Use `_underscore_` for italics, not `*single-star*`. Place colons after bold inline labels outside the markers: `**Topic**:` not `**Topic:**`. - **Bullets**: Use `-` for all unordered lists; one bullet per complete thought; never wrap a bullet's content mid-sentence onto a continuation line - split into separate bullets if too long or multi-thought. Nested sub-bullets for component grouping are permitted. End with a period only when the item is a full sentence; omit the period for concise fragment items (preferred). - **Prose**: Do not insert hard newlines to simulate visual wrapping. Keep each prose paragraph on one continuous physical line and let editors or viewers wrap it visually. Exception: commit message bodies use one sentence per line for `git log` readability. @@ -182,7 +182,7 @@ Apply to all generated output. If a discovered template deviates from any rule ( - **Consistency**: Use the same term for the same concept throughout; match the voice and tense of the template; do not mix header levels for parallel sections. - **KISS and DRY**: Each section and bullet conveys unique information - no redundancy or overlap. -> General Doc Constraints v1.1.1 - KemingHe/common-devx +> General Doc Constraints v1.2.0 - KemingHe/common-devx ## Skill Constraints diff --git a/.agents/skills/readme-creation/SKILL.md b/.agents/skills/readme-creation/SKILL.md index dd397c4..9fb8277 100644 --- a/.agents/skills/readme-creation/SKILL.md +++ b/.agents/skills/readme-creation/SKILL.md @@ -153,7 +153,7 @@ Present README in markdown following template structure. Target ~50 lines, max 1 Apply to all generated output. If a discovered template deviates from any rule (e.g., uses emojis semantically, uses a different bullet convention), note the deviation explicitly and confirm with the user before treating it as a permitted exception. -- **Characters**: QWERTY keyboard typeable only - no smart quotes, emojis, or special Unicode anywhere. In prose, do not use em-dashes or em-dash substitutes (`--`, ` -- `); use ` - ` (space-dash-space) for clause separation instead. Exception: `↑` for ToC navigation. +- **Characters**: QWERTY keyboard typeable only - no smart quotes, emojis, or special Unicode anywhere. In prose, do not use em-dashes or em-dash substitutes (`--`, ` -- `); use ` - ` (space-dash-space) for clause separation instead. Exceptions: `↑` for ToC navigation; Unicode box drawing characters for `tree`-style directory rendering. - **Inline formatting**: Use `_underscore_` for italics, not `*single-star*`. Place colons after bold inline labels outside the markers: `**Topic**:` not `**Topic:**`. - **Bullets**: Use `-` for all unordered lists; one bullet per complete thought; never wrap a bullet's content mid-sentence onto a continuation line - split into separate bullets if too long or multi-thought. Nested sub-bullets for component grouping are permitted. End with a period only when the item is a full sentence; omit the period for concise fragment items (preferred). - **Prose**: Do not insert hard newlines to simulate visual wrapping. Keep each prose paragraph on one continuous physical line and let editors or viewers wrap it visually. Exception: commit message bodies use one sentence per line for `git log` readability. @@ -161,7 +161,7 @@ Apply to all generated output. If a discovered template deviates from any rule ( - **Consistency**: Use the same term for the same concept throughout; match the voice and tense of the template; do not mix header levels for parallel sections. - **KISS and DRY**: Each section and bullet conveys unique information - no redundancy or overlap. -> General Doc Constraints v1.1.1 - KemingHe/common-devx +> General Doc Constraints v1.2.0 - KemingHe/common-devx ## Skill Constraints From daf35c13a2e3eb9f862df0157da83b456342653f Mon Sep 17 00:00:00 2001 From: Keming He Date: Mon, 1 Jun 2026 13:45:36 -0400 Subject: [PATCH 3/3] docs(documentation-review): bump to 2.1.0 and add contributor metadata closes #105 CHANGES - Bump version from 2.0.0 to 2.1.0 for checklist logic change in PR #104 - Add contributors field crediting puneetdixit200 - Update Characters checklist row to reflect GDC v1.2.0 box drawing exception --- .agents/skills/documentation-review/README.md | 2 +- .agents/skills/documentation-review/SKILL.md | 6 ++++-- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/.agents/skills/documentation-review/README.md b/.agents/skills/documentation-review/README.md index 1e5db64..f87756c 100644 --- a/.agents/skills/documentation-review/README.md +++ b/.agents/skills/documentation-review/README.md @@ -18,7 +18,7 @@ Ask your AI agent to review documentation: | Correctness | Valid YAML, working links | | Completeness | Required sections, no placeholders | | Freshness | Last Updated dates, versions | -| Characters | QWERTY-only everywhere; no smart quotes, emojis, or special Unicode; no em-dashes or `--`/` -- ` in prose; use ` - ` for separation. Exception: `↑` | +| Characters | QWERTY-only everywhere; no smart quotes, emojis, or special Unicode; no em-dashes or `--`/` -- ` in prose; use ` - ` for separation. Exceptions: `↑`; box drawing for `tree` output | | Inline formatting | `_underscore_` italics; colon outside bold (`**Topic**:`) | | Linter | IDE/editor warnings when available | | Output quality | Hard-wrapped bullets or prose that simulate visual wrapping; sentences broken across hard newlines; orphaned `(optional)` labels; unfilled `[placeholder]` text | diff --git a/.agents/skills/documentation-review/SKILL.md b/.agents/skills/documentation-review/SKILL.md index 5544c07..1c89763 100644 --- a/.agents/skills/documentation-review/SKILL.md +++ b/.agents/skills/documentation-review/SKILL.md @@ -7,7 +7,9 @@ description: | license: MIT metadata: author: KemingHe - version: "2.0.0" + contributors: + - puneetdixit200 + version: "2.1.0" --- # Documentation Review @@ -40,7 +42,7 @@ Determine files to review: | **Correctness** | Valid YAML/markdown, working links, accurate paths | | **Completeness** | Required sections present, no unfilled placeholders | | **Freshness** | Last Updated date, version numbers, changelog entries | -| **Characters** | QWERTY-only everywhere; no smart quotes, emojis, or special Unicode; no em-dashes or em-dash substitutes (`--`, ` -- `) in prose; use ` - ` for clause separation (exception: `↑`) | +| **Characters** | QWERTY-only everywhere; no smart quotes, emojis, or special Unicode; no em-dashes or em-dash substitutes (`--`, ` -- `) in prose; use ` - ` for clause separation (exceptions: `↑`; box drawing for `tree` output) | | **Inline formatting** | `_underscore_` italics only; colon outside bold label markers (`**Topic**:`) | | **Linter** | Check IDE/editor linter errors when available | | **Output quality** | Hard-wrapped bullets or prose that simulate visual wrapping; sentences broken across hard newlines; orphaned `(optional)` labels in populated sections; unfilled `[placeholder]` text; terminology inconsistency; KISS/DRY violations |