Skip to content

blog: Add descriptive diagrams and hero image to Copilot Skills blog post#34

Merged
diberry merged 23 commits into
mainfrom
blog/skills-blog-images
May 11, 2026
Merged

blog: Add descriptive diagrams and hero image to Copilot Skills blog post#34
diberry merged 23 commits into
mainfrom
blog/skills-blog-images

Conversation

@diberry
Copy link
Copy Markdown
Collaborator

@diberry diberry commented May 9, 2026

Replaces 6 generic screenshots with properly named mermaid diagrams and adds an SDXL watercolor hero image for the 'Tuning Up Copilot Skills' blog post.

Changes

  • 6 mermaid diagrams (dark theme, transparent bg, 1200px) with .mmd source files
  • 1 SDXL watercolor hero image — craftsperson's workshop illustration
  • Updated blog markdown with descriptive filenames and alt text
  • Deleted old generic image files (image6/11/14/15/17/21.png)

New images

Image Purpose
optimization-phases-plan.png 6-phase optimization roadmap
sdk-skills-before-after.png SDK skills 94%+ reduction per language
cumulative-savings.png Running totals after 3 phases
pr-summary.png PR #147 review summary
final-token-reduction.png 413K→143K headline result
shared-references-architecture.png Reference consolidation diagram
hero-skill-workshop.png Watercolor workshop illustration

diberry and others added 21 commits May 9, 2026 12:37
…ro watercolor

- Replace 6 generic screenshots (image6/11/14/15/17/21.png) with properly named mermaid diagrams
- Add SDXL-generated watercolor hero image (hero-skill-workshop.png)
- Include .mmd source files for all diagrams (dark theme, transparent bg)
- Update blog markdown with new image references and alt text

New images:
  optimization-phases-plan.png - 6-phase optimization roadmap
  sdk-skills-before-after.png - SDK skills 94%+ reduction per language
  cumulative-savings.png - Running totals after 3 phases
  pr-summary.png - PR #147 review summary
  final-token-reduction.png - 413K to 143K headline result
  shared-references-architecture.png - Reference consolidation diagram
  hero-skill-workshop.png - Watercolor workshop illustration

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…anguage dispatch)

The blog previously described creating a shared-references directory. This updates it to reflect the actual follow-up: consolidating all 7 SDK skills (6 languages + 1 quickstart) into a single unified skill with language auto-detection.

- Bonus Round: replaced shared-references story with consolidation story, mentioning waza isolation violation and the three options considered
- What Actually Worked: evolved pattern #4 to show progression from shared-references to unified routing
- Dogfooding: added note about SDK skills' third iteration
- Phase 2 and other sections unchanged

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Fix typos: 'ignoringthe' → 'ignoring the', 'directoryfor' → 'directory for'
- Clarify 800-token floor exception for unified skills (469 tokens)
- Explain PR #147 numbers vs Bonus Round consolidation
- Add bridge for unaccounted ~70K tokens (Phases 4-6)
- Fix 90% savings claim to 'three-quarters' (74%, not 90%)
- Add Honest Lessons row about stopping at Phase 4
- Clarify '136 files' as '136 skill and reference files (117 distinct skills)'
- Separate main session from Bonus Round follow-up session in timeline

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
… conversational)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Applied patterns from Phases 1-3 to finish medium and small skills.
Corrected 5 references that incorrectly claimed Phase 4 was incomplete.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…same data)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…ame data)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Replace estimate table with actuals showing 214K→143K breakdown
- Fix missing space after bold Key finding marker (line 180)
- Reframe Phase 1 ordering as noise reduction before high-impact work

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Remove github.com/diberry/project-dina link (private repo)
- Replace PR #147 and PR #188 with generic references
- No functional content changes

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Add opening line connecting hero image to the work
- Reference tidied workbench at Final Numbers midpoint
- Add closing bookend image (hero-skill-workshop-after.png) with prompt
- Workshop metaphor now threads: messy bench → organizing → clean bench

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Generated via SDXL with matching blue/amber watercolor palette.
Companion to hero-skill-workshop.png — same bench, now organized.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Previous image was a woodworker's bench; hero is a painter's studio.
Now both images show the same blue-walled artist studio — messy vs organized.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Same room composition as hero (blue walls, shelving, window, desk, chair)
but organized - supplies on shelves, palette laid out, brushes sorted.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Comment thread website/blog/2026-05-11-tuning-up-copilot-skills.md Outdated
diberry and others added 2 commits May 11, 2026 10:17
MDX parser treats <50 as JSX tag. Changed to prose.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@diberry diberry merged commit ad897b1 into main May 11, 2026
1 check passed
@diberry diberry deleted the blog/skills-blog-images branch May 11, 2026 17:22
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