feat(skills): Improve structure of any SKILL.md with a defined Workflow

Author: jabrena

documentation/MAINTENANCE.md

@@ -53,6 +53,7 @@ Can you update the current changelog for 0.15.0 comparing git commits in relatio
 # Review Skill registries
 https://github.com/jabrena/cursor-rules-java
 https://tessl.io/registry/skills/submit
+npx tessl skill review ./skills/xxx
 cd target && npx skills add jabrena/cursor-rules-java --all --agent cursor && cd ..
 ```
 

skills-generator/src/main/resources/skill-indexes/301-skill.xml

@@ -49,6 +49,13 @@ Apply Spring Boot Core guidelines for annotations, bean management, configuratio
     </trigger-list>
   </triggers>
 
+  <steps>
+    <step number="1"><step-title>Read reference and assess project context</step-title><step-content>Read `references/301-frameworks-spring-boot-core.md` and inspect the current project setup before proposing changes.</step-content></step>
+    <step number="2"><step-title>Gather scope and decide target improvements</step-title><step-content>Identify requested outcomes, constraints, and the minimum safe set of changes to apply.</step-content></step>
+    <step number="3"><step-title>Apply framework-aligned changes</step-title><step-content>Implement or refactor configuration/code following the reference patterns and project conventions.</step-content></step>
+    <step number="4"><step-title>Run verification and report results</step-title><step-content>Execute appropriate build/tests and summarize what changed, what was verified, and any follow-up actions.</step-content></step>
+  </steps>
+
   <references>
     <reference-list>
         <reference>references/301-frameworks-spring-boot-core.md</reference>

skills-generator/src/main/resources/skill-indexes/302-skill.xml

@@ -53,6 +53,13 @@ Apply REST API design principles for Spring Boot applications.
     </trigger-list>
   </triggers>
 
+  <steps>
+    <step number="1"><step-title>Read reference and assess project context</step-title><step-content>Read `references/302-frameworks-spring-boot-rest.md` and inspect the current project setup before proposing changes.</step-content></step>
+    <step number="2"><step-title>Gather scope and decide target improvements</step-title><step-content>Identify requested outcomes, constraints, and the minimum safe set of changes to apply.</step-content></step>
+    <step number="3"><step-title>Apply framework-aligned changes</step-title><step-content>Implement or refactor configuration/code following the reference patterns and project conventions.</step-content></step>
+    <step number="4"><step-title>Run verification and report results</step-title><step-content>Execute appropriate build/tests and summarize what changed, what was verified, and any follow-up actions.</step-content></step>
+  </steps>
+
   <references>
     <reference-list>
         <reference>references/302-frameworks-spring-boot-rest.md</reference>

skills-generator/src/main/resources/skill-indexes/311-skill.xml

@@ -51,6 +51,13 @@ Apply Spring JDBC guidelines with JdbcClient as the default; use JdbcTemplate /
     </trigger-list>
   </triggers>
 
+  <steps>
+    <step number="1"><step-title>Read reference and assess project context</step-title><step-content>Read `references/311-frameworks-spring-jdbc.md` and inspect the current project setup before proposing changes.</step-content></step>
+    <step number="2"><step-title>Gather scope and decide target improvements</step-title><step-content>Identify requested outcomes, constraints, and the minimum safe set of changes to apply.</step-content></step>
+    <step number="3"><step-title>Apply framework-aligned changes</step-title><step-content>Implement or refactor configuration/code following the reference patterns and project conventions.</step-content></step>
+    <step number="4"><step-title>Run verification and report results</step-title><step-content>Execute appropriate build/tests and summarize what changed, what was verified, and any follow-up actions.</step-content></step>
+  </steps>
+
   <references>
     <reference-list>
         <reference>references/311-frameworks-spring-jdbc.md</reference>

skills-generator/src/main/resources/skill-indexes/312-skill.xml

@@ -46,6 +46,13 @@ Apply Spring Data JDBC guidelines with Java records.
     </trigger-list>
   </triggers>
 
+  <steps>
+    <step number="1"><step-title>Read reference and assess project context</step-title><step-content>Read `references/312-frameworks-spring-data-jdbc.md` and inspect the current project setup before proposing changes.</step-content></step>
+    <step number="2"><step-title>Gather scope and decide target improvements</step-title><step-content>Identify requested outcomes, constraints, and the minimum safe set of changes to apply.</step-content></step>
+    <step number="3"><step-title>Apply framework-aligned changes</step-title><step-content>Implement or refactor configuration/code following the reference patterns and project conventions.</step-content></step>
+    <step number="4"><step-title>Run verification and report results</step-title><step-content>Execute appropriate build/tests and summarize what changed, what was verified, and any follow-up actions.</step-content></step>
+  </steps>
+
   <references>
     <reference-list>
         <reference>references/312-frameworks-spring-data-jdbc.md</reference>

skills-generator/src/main/resources/skill-indexes/313-skill.xml

@@ -42,6 +42,13 @@ Apply Flyway migration guidelines for Spring Boot.
     </trigger-list>
   </triggers>
 
+  <steps>
+    <step number="1"><step-title>Read reference and assess project context</step-title><step-content>Read `references/313-frameworks-spring-db-migrations-flyway.md` and inspect the current project setup before proposing changes.</step-content></step>
+    <step number="2"><step-title>Gather scope and decide target improvements</step-title><step-content>Identify requested outcomes, constraints, and the minimum safe set of changes to apply.</step-content></step>
+    <step number="3"><step-title>Apply framework-aligned changes</step-title><step-content>Implement or refactor configuration/code following the reference patterns and project conventions.</step-content></step>
+    <step number="4"><step-title>Run verification and report results</step-title><step-content>Execute appropriate build/tests and summarize what changed, what was verified, and any follow-up actions.</step-content></step>
+  </steps>
+
   <references>
     <reference-list>
         <reference>references/313-frameworks-spring-db-migrations-flyway.md</reference>

skills-generator/src/main/resources/skill-indexes/321-skill.xml

@@ -43,6 +43,13 @@ Apply Spring Boot unit testing guidelines with Mockito.
     </trigger-list>
   </triggers>
 
+  <steps>
+    <step number="1"><step-title>Read reference and assess project context</step-title><step-content>Read `references/321-frameworks-spring-boot-testing-unit-tests.md` and inspect the current project setup before proposing changes.</step-content></step>
+    <step number="2"><step-title>Gather scope and decide target improvements</step-title><step-content>Identify requested outcomes, constraints, and the minimum safe set of changes to apply.</step-content></step>
+    <step number="3"><step-title>Apply framework-aligned changes</step-title><step-content>Implement or refactor configuration/code following the reference patterns and project conventions.</step-content></step>
+    <step number="4"><step-title>Run verification and report results</step-title><step-content>Execute appropriate build/tests and summarize what changed, what was verified, and any follow-up actions.</step-content></step>
+  </steps>
+
   <references>
     <reference-list>
         <reference>references/321-frameworks-spring-boot-testing-unit-tests.md</reference>

skills-generator/src/main/resources/skill-indexes/322-skill.xml

@@ -46,6 +46,13 @@ Apply Spring Boot integration testing guidelines for Spring Boot 4.0.x.
     </trigger-list>
   </triggers>
 
+  <steps>
+    <step number="1"><step-title>Read reference and assess project context</step-title><step-content>Read `references/322-frameworks-spring-boot-testing-integration-tests.md` and inspect the current project setup before proposing changes.</step-content></step>
+    <step number="2"><step-title>Gather scope and decide target improvements</step-title><step-content>Identify requested outcomes, constraints, and the minimum safe set of changes to apply.</step-content></step>
+    <step number="3"><step-title>Apply framework-aligned changes</step-title><step-content>Implement or refactor configuration/code following the reference patterns and project conventions.</step-content></step>
+    <step number="4"><step-title>Run verification and report results</step-title><step-content>Execute appropriate build/tests and summarize what changed, what was verified, and any follow-up actions.</step-content></step>
+  </steps>
+
   <references>
     <reference-list>
         <reference>references/322-frameworks-spring-boot-testing-integration-tests.md</reference>

skills-generator/src/main/resources/skill-indexes/323-skill.xml

@@ -49,6 +49,13 @@ Implement acceptance tests from Gherkin feature files in Spring Boot projects. G
     </trigger-list>
   </triggers>
 
+  <steps>
+    <step number="1"><step-title>Read reference and assess project context</step-title><step-content>Read `references/323-frameworks-spring-boot-testing-acceptance-tests.md` and inspect the current project setup before proposing changes.</step-content></step>
+    <step number="2"><step-title>Gather scope and decide target improvements</step-title><step-content>Identify requested outcomes, constraints, and the minimum safe set of changes to apply.</step-content></step>
+    <step number="3"><step-title>Apply framework-aligned changes</step-title><step-content>Implement or refactor configuration/code following the reference patterns and project conventions.</step-content></step>
+    <step number="4"><step-title>Run verification and report results</step-title><step-content>Execute appropriate build/tests and summarize what changed, what was verified, and any follow-up actions.</step-content></step>
+  </steps>
+
   <references>
     <reference-list>
         <reference>references/323-frameworks-spring-boot-testing-acceptance-tests.md</reference>

skills-generator/src/main/resources/skill-indexes/401-skill.xml

@@ -53,6 +53,12 @@ Apply Quarkus core guidelines for CDI beans, configuration, profiles, and lifecy
         <trigger>Add virtual-thread configuration or tune CDI lifecycle</trigger>
     </trigger-list>
   </triggers>
+  <steps>
+    <step number="1"><step-title>Read reference and assess project context</step-title><step-content>Read `references/401-frameworks-quarkus-core.md` and inspect the current project setup before proposing changes.</step-content></step>
+    <step number="2"><step-title>Gather scope and decide target improvements</step-title><step-content>Identify requested outcomes, constraints, and the minimum safe set of changes to apply.</step-content></step>
+    <step number="3"><step-title>Apply framework-aligned changes</step-title><step-content>Implement or refactor configuration/code following the reference patterns and project conventions.</step-content></step>
+    <step number="4"><step-title>Run verification and report results</step-title><step-content>Execute appropriate build/tests and summarize what changed, what was verified, and any follow-up actions.</step-content></step>
+  </steps>
 
   <references>
     <reference-list>