agentic-skill-mill 1.0.8 → 1.0.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.
@@ -504,6 +504,35 @@ Use conventional commit format with a detailed body:
504
504
 
505
505
  The commit body should list every file category changed (core modules, CLI wrappers, fragments, manifest, etc.) and what was done in each.
506
506
 
507
+ ### Cross-Artifact Skill Signature
508
+
509
+ When updating or creating a skill, embed a deterministic signature in each externally searchable artifact so operators can query everything produced by that specific skill across systems.
510
+
511
+ Derive the signature per skill name:
512
+
513
+ - Compute `sha256("<skill-name>")`
514
+ - Use the first 8 lowercase hex characters
515
+ - Format as `skill-sig: <sig8>`
516
+
517
+ For a given skill name, the value is permanently static across all versions.
518
+
519
+ Example:
520
+
521
+ - `sha256("3pp-skill")` -> `ad61853a...`
522
+ - signature value: `skill-sig: ad61853a`
523
+
524
+ ### Artifact Embedding Rules
525
+
526
+ - **Commit message body**: append a git trailer after a blank line: `Skill-Sig: <sig8>`
527
+ - **PR markdown doc**: append `<sub>skill-sig: <sig8></sub>` after the `## Notes` section
528
+ - **GUS HTML details**: append `<p style="font-size:0.8em;color:#888">skill-sig: <sig8></p>` before closing `</body></html>`
529
+
530
+ ### Searchability Targets
531
+
532
+ - Git: `git log --grep="skill-sig: <sig8>"`
533
+ - GitHub: search for `"skill-sig: <sig8>"`
534
+ - GUS SOQL: `WHERE Details__c LIKE '%skill-sig: <sig8>%'`
535
+
507
536
  ---
508
537
 
509
538
  ## Anti-Patterns
@@ -504,6 +504,35 @@ Use conventional commit format with a detailed body:
504
504
 
505
505
  The commit body should list every file category changed (core modules, CLI wrappers, fragments, manifest, etc.) and what was done in each.
506
506
 
507
+ ### Cross-Artifact Skill Signature
508
+
509
+ When updating or creating a skill, embed a deterministic signature in each externally searchable artifact so operators can query everything produced by that specific skill across systems.
510
+
511
+ Derive the signature per skill name:
512
+
513
+ - Compute `sha256("<skill-name>")`
514
+ - Use the first 8 lowercase hex characters
515
+ - Format as `skill-sig: <sig8>`
516
+
517
+ For a given skill name, the value is permanently static across all versions.
518
+
519
+ Example:
520
+
521
+ - `sha256("3pp-skill")` -> `ad61853a...`
522
+ - signature value: `skill-sig: ad61853a`
523
+
524
+ ### Artifact Embedding Rules
525
+
526
+ - **Commit message body**: append a git trailer after a blank line: `Skill-Sig: <sig8>`
527
+ - **PR markdown doc**: append `<sub>skill-sig: <sig8></sub>` after the `## Notes` section
528
+ - **GUS HTML details**: append `<p style="font-size:0.8em;color:#888">skill-sig: <sig8></p>` before closing `</body></html>`
529
+
530
+ ### Searchability Targets
531
+
532
+ - Git: `git log --grep="skill-sig: <sig8>"`
533
+ - GitHub: search for `"skill-sig: <sig8>"`
534
+ - GUS SOQL: `WHERE Details__c LIKE '%skill-sig: <sig8>%'`
535
+
507
536
  ---
508
537
 
509
538
  ## Anti-Patterns
@@ -504,6 +504,35 @@ Use conventional commit format with a detailed body:
504
504
 
505
505
  The commit body should list every file category changed (core modules, CLI wrappers, fragments, manifest, etc.) and what was done in each.
506
506
 
507
+ ### Cross-Artifact Skill Signature
508
+
509
+ When updating or creating a skill, embed a deterministic signature in each externally searchable artifact so operators can query everything produced by that specific skill across systems.
510
+
511
+ Derive the signature per skill name:
512
+
513
+ - Compute `sha256("<skill-name>")`
514
+ - Use the first 8 lowercase hex characters
515
+ - Format as `skill-sig: <sig8>`
516
+
517
+ For a given skill name, the value is permanently static across all versions.
518
+
519
+ Example:
520
+
521
+ - `sha256("3pp-skill")` -> `ad61853a...`
522
+ - signature value: `skill-sig: ad61853a`
523
+
524
+ ### Artifact Embedding Rules
525
+
526
+ - **Commit message body**: append a git trailer after a blank line: `Skill-Sig: <sig8>`
527
+ - **PR markdown doc**: append `<sub>skill-sig: <sig8></sub>` after the `## Notes` section
528
+ - **GUS HTML details**: append `<p style="font-size:0.8em;color:#888">skill-sig: <sig8></p>` before closing `</body></html>`
529
+
530
+ ### Searchability Targets
531
+
532
+ - Git: `git log --grep="skill-sig: <sig8>"`
533
+ - GitHub: search for `"skill-sig: <sig8>"`
534
+ - GUS SOQL: `WHERE Details__c LIKE '%skill-sig: <sig8>%'`
535
+
507
536
  ---
508
537
 
509
538
  ## Anti-Patterns
@@ -504,6 +504,35 @@ Use conventional commit format with a detailed body:
504
504
 
505
505
  The commit body should list every file category changed (core modules, CLI wrappers, fragments, manifest, etc.) and what was done in each.
506
506
 
507
+ ### Cross-Artifact Skill Signature
508
+
509
+ When updating or creating a skill, embed a deterministic signature in each externally searchable artifact so operators can query everything produced by that specific skill across systems.
510
+
511
+ Derive the signature per skill name:
512
+
513
+ - Compute `sha256("<skill-name>")`
514
+ - Use the first 8 lowercase hex characters
515
+ - Format as `skill-sig: <sig8>`
516
+
517
+ For a given skill name, the value is permanently static across all versions.
518
+
519
+ Example:
520
+
521
+ - `sha256("3pp-skill")` -> `ad61853a...`
522
+ - signature value: `skill-sig: ad61853a`
523
+
524
+ ### Artifact Embedding Rules
525
+
526
+ - **Commit message body**: append a git trailer after a blank line: `Skill-Sig: <sig8>`
527
+ - **PR markdown doc**: append `<sub>skill-sig: <sig8></sub>` after the `## Notes` section
528
+ - **GUS HTML details**: append `<p style="font-size:0.8em;color:#888">skill-sig: <sig8></p>` before closing `</body></html>`
529
+
530
+ ### Searchability Targets
531
+
532
+ - Git: `git log --grep="skill-sig: <sig8>"`
533
+ - GitHub: search for `"skill-sig: <sig8>"`
534
+ - GUS SOQL: `WHERE Details__c LIKE '%skill-sig: <sig8>%'`
535
+
507
536
  ---
508
537
 
509
538
  ## Anti-Patterns
@@ -508,6 +508,35 @@ Use conventional commit format with a detailed body:
508
508
 
509
509
  The commit body should list every file category changed (core modules, CLI wrappers, fragments, manifest, etc.) and what was done in each.
510
510
 
511
+ ### Cross-Artifact Skill Signature
512
+
513
+ When updating or creating a skill, embed a deterministic signature in each externally searchable artifact so operators can query everything produced by that specific skill across systems.
514
+
515
+ Derive the signature per skill name:
516
+
517
+ - Compute `sha256("<skill-name>")`
518
+ - Use the first 8 lowercase hex characters
519
+ - Format as `skill-sig: <sig8>`
520
+
521
+ For a given skill name, the value is permanently static across all versions.
522
+
523
+ Example:
524
+
525
+ - `sha256("3pp-skill")` -> `ad61853a...`
526
+ - signature value: `skill-sig: ad61853a`
527
+
528
+ ### Artifact Embedding Rules
529
+
530
+ - **Commit message body**: append a git trailer after a blank line: `Skill-Sig: <sig8>`
531
+ - **PR markdown doc**: append `<sub>skill-sig: <sig8></sub>` after the `## Notes` section
532
+ - **GUS HTML details**: append `<p style="font-size:0.8em;color:#888">skill-sig: <sig8></p>` before closing `</body></html>`
533
+
534
+ ### Searchability Targets
535
+
536
+ - Git: `git log --grep="skill-sig: <sig8>"`
537
+ - GitHub: search for `"skill-sig: <sig8>"`
538
+ - GUS SOQL: `WHERE Details__c LIKE '%skill-sig: <sig8>%'`
539
+
511
540
  ---
512
541
 
513
542
  ## Anti-Patterns
@@ -504,6 +504,35 @@ Use conventional commit format with a detailed body:
504
504
 
505
505
  The commit body should list every file category changed (core modules, CLI wrappers, fragments, manifest, etc.) and what was done in each.
506
506
 
507
+ ### Cross-Artifact Skill Signature
508
+
509
+ When updating or creating a skill, embed a deterministic signature in each externally searchable artifact so operators can query everything produced by that specific skill across systems.
510
+
511
+ Derive the signature per skill name:
512
+
513
+ - Compute `sha256("<skill-name>")`
514
+ - Use the first 8 lowercase hex characters
515
+ - Format as `skill-sig: <sig8>`
516
+
517
+ For a given skill name, the value is permanently static across all versions.
518
+
519
+ Example:
520
+
521
+ - `sha256("3pp-skill")` -> `ad61853a...`
522
+ - signature value: `skill-sig: ad61853a`
523
+
524
+ ### Artifact Embedding Rules
525
+
526
+ - **Commit message body**: append a git trailer after a blank line: `Skill-Sig: <sig8>`
527
+ - **PR markdown doc**: append `<sub>skill-sig: <sig8></sub>` after the `## Notes` section
528
+ - **GUS HTML details**: append `<p style="font-size:0.8em;color:#888">skill-sig: <sig8></p>` before closing `</body></html>`
529
+
530
+ ### Searchability Targets
531
+
532
+ - Git: `git log --grep="skill-sig: <sig8>"`
533
+ - GitHub: search for `"skill-sig: <sig8>"`
534
+ - GUS SOQL: `WHERE Details__c LIKE '%skill-sig: <sig8>%'`
535
+
507
536
  ---
508
537
 
509
538
  ## Anti-Patterns
@@ -504,6 +504,35 @@ Use conventional commit format with a detailed body:
504
504
 
505
505
  The commit body should list every file category changed (core modules, CLI wrappers, fragments, manifest, etc.) and what was done in each.
506
506
 
507
+ ### Cross-Artifact Skill Signature
508
+
509
+ When updating or creating a skill, embed a deterministic signature in each externally searchable artifact so operators can query everything produced by that specific skill across systems.
510
+
511
+ Derive the signature per skill name:
512
+
513
+ - Compute `sha256("<skill-name>")`
514
+ - Use the first 8 lowercase hex characters
515
+ - Format as `skill-sig: <sig8>`
516
+
517
+ For a given skill name, the value is permanently static across all versions.
518
+
519
+ Example:
520
+
521
+ - `sha256("3pp-skill")` -> `ad61853a...`
522
+ - signature value: `skill-sig: ad61853a`
523
+
524
+ ### Artifact Embedding Rules
525
+
526
+ - **Commit message body**: append a git trailer after a blank line: `Skill-Sig: <sig8>`
527
+ - **PR markdown doc**: append `<sub>skill-sig: <sig8></sub>` after the `## Notes` section
528
+ - **GUS HTML details**: append `<p style="font-size:0.8em;color:#888">skill-sig: <sig8></p>` before closing `</body></html>`
529
+
530
+ ### Searchability Targets
531
+
532
+ - Git: `git log --grep="skill-sig: <sig8>"`
533
+ - GitHub: search for `"skill-sig: <sig8>"`
534
+ - GUS SOQL: `WHERE Details__c LIKE '%skill-sig: <sig8>%'`
535
+
507
536
  ---
508
537
 
509
538
  ## Anti-Patterns
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agentic-skill-mill",
3
- "version": "1.0.8",
3
+ "version": "1.0.9",
4
4
  "description": "Forge and refine agent skill projects -- fragment-composed skills compiled to 7 IDE targets with a companion CLI",
5
5
  "type": "module",
6
6
  "bin": {
@@ -18,7 +18,8 @@
18
18
  "meta/core-module-pattern.md",
19
19
  "meta/cli-command-pattern.md",
20
20
  "meta/fragment-composition.md",
21
- "meta/rename-workflow.md"
21
+ "meta/rename-workflow.md",
22
+ "meta/skill-signature.md"
22
23
  ]
23
24
  }
24
25
  },
@@ -0,0 +1,28 @@
1
+ ### Cross-Artifact Skill Signature
2
+
3
+ When updating or creating a skill, embed a deterministic signature in each externally searchable artifact so operators can query everything produced by that specific skill across systems.
4
+
5
+ Derive the signature per skill name:
6
+
7
+ - Compute `sha256("<skill-name>")`
8
+ - Use the first 8 lowercase hex characters
9
+ - Format as `skill-sig: <sig8>`
10
+
11
+ For a given skill name, the value is permanently static across all versions.
12
+
13
+ Example:
14
+
15
+ - `sha256("3pp-skill")` -> `ad61853a...`
16
+ - signature value: `skill-sig: ad61853a`
17
+
18
+ ### Artifact Embedding Rules
19
+
20
+ - **Commit message body**: append a git trailer after a blank line: `Skill-Sig: <sig8>`
21
+ - **PR markdown doc**: append `<sub>skill-sig: <sig8></sub>` after the `## Notes` section
22
+ - **GUS HTML details**: append `<p style="font-size:0.8em;color:#888">skill-sig: <sig8></p>` before closing `</body></html>`
23
+
24
+ ### Searchability Targets
25
+
26
+ - Git: `git log --grep="skill-sig: <sig8>"`
27
+ - GitHub: search for `"skill-sig: <sig8>"`
28
+ - GUS SOQL: `WHERE Details__c LIKE '%skill-sig: <sig8>%'`
@@ -125,6 +125,8 @@ Use conventional commit format with a detailed body:
125
125
 
126
126
  The commit body should list every file category changed (core modules, CLI wrappers, fragments, manifest, etc.) and what was done in each.
127
127
 
128
+ {{include:meta/skill-signature.md}}
129
+
128
130
  ---
129
131
 
130
132
  ## Anti-Patterns