From d4be6c1cc92a4d9b747b41e13f38ae0e7bf15b65 Mon Sep 17 00:00:00 2001
From: "botantler-1[bot]" <185060876+botantler-1[bot]@users.noreply.github.com>
Date: Mon, 26 Oct 2026 06:25:05 +0000
Subject: [PATCH 1/2] chore(deps): update agent skills
 (plugins/engineering-practices/skills/write-readme)

---
 .../engineering-practices/skills/write-readme/SKILL.md    | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/plugins/engineering-practices/skills/write-readme/SKILL.md b/plugins/engineering-practices/skills/write-readme/SKILL.md
index 5f3a933..826613c 100644
--- a/plugins/engineering-practices/skills/write-readme/SKILL.md
+++ b/plugins/engineering-practices/skills/write-readme/SKILL.md
@@ -3,9 +3,9 @@ description: Write or improve a newcomer-facing README with a clear product over
 license: Apache-2.0
 metadata:
     github-path: write-readme
-    github-ref: refs/tags/v1.24.1
+    github-ref: refs/tags/v1.28.1
     github-repo: https://github.com/devantler-tech/agent-skills
-    github-tree-sha: 02451fe8f1c139a29ad1a404dc1f0abc5c0e0c8f
+    github-tree-sha: f5de4610a39834eefc9c25ae8e1c80b66e0914d3
 name: write-readme
 ---
 # Write a useful README
@@ -31,6 +31,10 @@ product, not its development history. Use short paragraphs, familiar words and c
 Keep names readers use to recognize compatibility: “Encrypt secrets with SOPS” is clearer than
 either a bare tool list or a long explanation of encryption internals.
 
+Draw any diagram as a Mermaid block, which GitHub renders, never as ASCII art or box-drawing
+characters: fixed-width drawings overflow phone screens and screen readers read them as noise.
+Prefer a top-down layout with short labels, and keep any directory tree short and narrow.
+
 Use bullets for distinct benefits and a compact table when comparison helps. Keep a useful feature
 overview visible; do not move every reason to choose the product into a reference document. Avoid
 repeating the introduction, explaining every technical noun, or adding warnings for hypothetical

From 0afaf12162a990d54dac9dd33ee25d37e08956fe Mon Sep 17 00:00:00 2001
From: "botantler-1[bot]" <185060876+botantler-1[bot]@users.noreply.github.com>
Date: Mon, 26 Oct 2026 06:25:36 +0000
Subject: [PATCH 2/2] chore(deps): refresh plugin metadata for synced content

---
 .claude-plugin/marketplace.json                          | 2 +-
 .github/plugin/marketplace.json                          | 2 +-
 plugins/engineering-practices/.claude-plugin/plugin.json | 2 +-
 plugins/engineering-practices/CHANGELOG.md               | 4 ++++
 plugins/engineering-practices/plugin.json                | 2 +-
 5 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index f5db280..b5ef0d1 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -39,7 +39,7 @@
     {
       "name": "engineering-practices",
       "description": "Git commits, conventional releases, refactoring, test-driven development, and engineering ways of working skills",
-      "version": "1.1.5",
+      "version": "1.1.6",
       "source": "./plugins/engineering-practices"
     },
     {
diff --git a/.github/plugin/marketplace.json b/.github/plugin/marketplace.json
index f5db280..b5ef0d1 100644
--- a/.github/plugin/marketplace.json
+++ b/.github/plugin/marketplace.json
@@ -39,7 +39,7 @@
     {
       "name": "engineering-practices",
       "description": "Git commits, conventional releases, refactoring, test-driven development, and engineering ways of working skills",
-      "version": "1.1.5",
+      "version": "1.1.6",
       "source": "./plugins/engineering-practices"
     },
     {
diff --git a/plugins/engineering-practices/.claude-plugin/plugin.json b/plugins/engineering-practices/.claude-plugin/plugin.json
index 76cbe77..3aab7b0 100644
--- a/plugins/engineering-practices/.claude-plugin/plugin.json
+++ b/plugins/engineering-practices/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "name": "engineering-practices",
   "description": "Git commits, conventional releases, refactoring, test-driven development, and engineering ways of working skills",
-  "version": "1.1.5",
+  "version": "1.1.6",
   "author": {
     "name": "devantler-tech",
     "url": "https://github.com/devantler-tech"
diff --git a/plugins/engineering-practices/CHANGELOG.md b/plugins/engineering-practices/CHANGELOG.md
index f056d50..7a750f8 100644
--- a/plugins/engineering-practices/CHANGELOG.md
+++ b/plugins/engineering-practices/CHANGELOG.md
@@ -1,5 +1,9 @@
 # Changelog — `engineering-practices`
 
+## 1.1.6 — 2026-10-26
+
+**Changed** — sync `write-readme` from `https://github.com/devantler-tech/agent-skills` at `refs/tags/v1.28.1`.
+
 ## 1.1.5 — 2026-10-25
 
 **Changed** — sync `git-commit` from `https://github.com/github/awesome-copilot` at `e24be77e6f203409cf99ab7d5a67e1540cb386d3`.
diff --git a/plugins/engineering-practices/plugin.json b/plugins/engineering-practices/plugin.json
index 76cbe77..3aab7b0 100644
--- a/plugins/engineering-practices/plugin.json
+++ b/plugins/engineering-practices/plugin.json
@@ -1,7 +1,7 @@
 {
   "name": "engineering-practices",
   "description": "Git commits, conventional releases, refactoring, test-driven development, and engineering ways of working skills",
-  "version": "1.1.5",
+  "version": "1.1.6",
   "author": {
     "name": "devantler-tech",
     "url": "https://github.com/devantler-tech"