Skip to content

fix(skills): remove bold principle sentences and add Verification sections#61

Merged
olegshulyakov merged 2 commits into
mainfrom
fix/skills-align-skills-authoring
May 25, 2026
Merged

fix(skills): remove bold principle sentences and add Verification sections#61
olegshulyakov merged 2 commits into
mainfrom
fix/skills-align-skills-authoring

Conversation

@olegshulyakov

Copy link
Copy Markdown
Collaborator
  • Strip bold principle sentences following ## headings across all SKILL.md files and references
  • Add standalone --- delimiters between sections for clear model-context segmentation
  • Add ## Verification sections with actionable checklists
  • Update authoring guidance: bold sentences after headings are no longer required
  • Quick-validate now rejects bold principle sentences after headings
  • Fix write-spec reference templates: wrap YAML frontmatter and body in code fences
  • Update manage-git/branch-naming examples with bold scan anchors
  • Record skill audit grouping decision in MEMORY.md

…tions

- Strip bold principle sentences following `##` headings across all SKILL.md files and references
- Add standalone `---` delimiters between sections for clear model-context segmentation
- Add `## Verification` sections with actionable checklists
- Update authoring guidance: bold sentences after headings are no longer required
- Quick-validate now rejects bold principle sentences after headings
- Fix write-spec reference templates: wrap YAML frontmatter and body in code fences
- Update manage-git/branch-naming examples with bold scan anchors
- Record skill audit grouping decision in MEMORY.md
@github-actions

github-actions Bot commented May 25, 2026

Copy link
Copy Markdown

Library Token Diff

Estimated token changes for files under .agents/.

File Status Before After Delta
memory/MEMORY.md modified 686 850 +164
skills/ask-questions/SKILL.md modified 541 463 -78
skills/audit-skill-security/references/audit-protocol.md modified 1084 1105 +21
skills/audit-skill-security/SKILL.md modified 635 679 +44
skills/build-backend/SKILL.md modified 1959 1971 +12
skills/build-database/references/analytics.md modified 421 378 -43
skills/build-database/references/bigquery.md modified 258 229 -29
skills/build-database/references/clickhouse.md modified 250 220 -30
skills/build-database/references/cockroachdb.md modified 274 245 -29
skills/build-database/references/common.md modified 1193 1151 -42
skills/build-database/references/migration.md modified 541 485 -56
skills/build-database/references/mssql.md modified 938 884 -54
skills/build-database/references/mysql.md modified 945 835 -110
skills/build-database/references/oracle.md modified 1134 1028 -106
skills/build-database/references/postgres.md modified 937 827 -110
skills/build-database/references/schema-design.md modified 2478 2398 -80
skills/build-database/references/snowflake.md modified 243 214 -29
skills/build-database/references/sqlite.md modified 1062 976 -86
skills/build-database/SKILL.md modified 1086 1053 -33
skills/build-frontend/SKILL.md modified 1539 1554 +15
skills/build-tests/references/api.md modified 700 619 -81
skills/build-tests/references/e2e.md modified 797 726 -71
skills/build-tests/references/perf.md modified 737 657 -80
skills/build-tests/SKILL.md modified 871 883 +12
skills/classify-content/SKILL.md modified 496 425 -71
skills/coordinate-work/SKILL.md modified 514 433 -81
skills/create-skill/references/authoring.md modified 1788 1745 -43
skills/create-skill/scripts/quick_validate.py modified 3068 3151 +83
skills/create-skill/SKILL.md modified 863 863 0
skills/decide-direction/SKILL.md modified 471 394 -77
skills/design-api/references/asyncapi.md modified 346 361 +15
skills/design-api/references/graphql.md modified 252 264 +12
skills/design-api/references/openapi.md modified 398 410 +12
skills/design-api/SKILL.md modified 376 420 +44
skills/explain-topic/SKILL.md modified 1392 1300 -92
skills/explore-context/SKILL.md modified 510 438 -72
skills/manage-git/references/branch-naming.md modified 1041 1077 +36
skills/manage-git/references/commit-message.md modified 1142 1239 +97
skills/manage-git/SKILL.md modified 543 621 +78
skills/plan-work/SKILL.md modified 488 414 -74
skills/reason-problem/SKILL.md modified 476 404 -72
skills/remember-context/SKILL.md modified 562 484 -78
skills/review-code/references/checklist.md modified 674 582 -92
skills/review-code/references/performance.md modified 412 347 -65
skills/review-code/references/regressions.md modified 437 395 -42
skills/review-code/references/security.md modified 695 610 -85
skills/review-code/references/test-gaps.md modified 510 454 -56
skills/review-code/SKILL.md modified 924 930 +6
skills/write-prd/references/examples.md modified 1763 1753 -10
skills/write-prd/references/output-format.md modified 1242 1216 -26
skills/write-prd/SKILL.md modified 1227 1196 -31
skills/write-spec/references/data-contract.md modified 798 868 +70
skills/write-spec/references/design-ui.md modified 846 903 +57
skills/write-spec/references/functional.md modified 1084 1057 -27
skills/write-spec/references/non-functional.md modified 1062 1132 +70
skills/write-spec/references/technical.md modified 1761 1732 -29
skills/write-spec/SKILL.md modified 937 941 +4
skills/write-tech-docs/references/api-docs.md modified 1799 1814 +15
skills/write-tech-docs/references/changelog.md modified 1590 1608 +18
skills/write-tech-docs/references/readme.md modified 1050 1058 +8
skills/write-tech-docs/references/release-notes.md modified 1255 1327 +72
skills/write-tech-docs/references/runbook-oncall.md modified 1852 1851 -1
skills/write-tech-docs/references/runbook-routine.md modified 1019 1028 +9
skills/write-tech-docs/SKILL.md modified 796 808 +12
skills/write-user-story/references/ai-output-format.md modified 919 904 -15
skills/write-user-story/references/examples.md modified 611 598 -13
skills/write-user-story/references/output-format.md modified 785 772 -13
skills/write-user-story/SKILL.md modified 1299 1284 -15
Total 63382 62041 -1341

Counts use the repository's local Markdown body token estimator, so they are for review comparison rather than provider billing.

@olegshulyakov olegshulyakov merged commit 369fb8c into main May 25, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant