Standardize skill repository layout

Author: romgenie

.gitignore

@@ -6,3 +6,20 @@ venv/
 .env
 .env.*
 !/.env.example
+
+# Shared skill layout ignores
+*$py.class
+Thumbs.db
+desktop.ini
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+env/
+ENV/
+!.env.example
+secrets.json
+*_secret.ini
+*_local.ini
+preview/
+output/
+*.tmp

README.md

@@ -24,6 +24,9 @@ Part of the CompleteTech LLC agentic services skill library. This skill supports
 
 ## Workflow Diagram
 
+Source: [assets/diagrams/workflow.mmd](assets/diagrams/workflow.mmd).
+
+
 ```mermaid
 flowchart LR
   A[Approved scope] --> B[Kickoff and access]

assets/diagrams/workflow.mmd

@@ -0,0 +1,14 @@
+flowchart LR
+  A[Approved scope] --> B[Kickoff and access]
+  B --> C[Project controls]
+  C --> D[Prototype and evaluation]
+  D --> E{Acceptance ready?}
+  E -->|No| F[Remediation and change control]
+  F --> C
+  E -->|Yes| G[Launch, support, and handoff]
+  classDef source fill:#eef6ff,stroke:#3778c2,color:#102a43;
+  classDef gate fill:#fff7e6,stroke:#c97a12,color:#3d2600;
+  classDef output fill:#eefaf0,stroke:#2f8f46,color:#12351d;
+  class A,B,C,D source;
+  class E gate;
+  class F,G output;

examples/README.md

@@ -0,0 +1,5 @@
+# Examples
+
+This directory is reserved for runnable example inputs, overrides, or notes for this skill.
+
+Rendered demonstration artifacts live under `assets/examples/` so README previews and packaged outputs stay close to the visual assets they reference.