docs: add pitfalls reference doc and version tracking to nous-branding skill #37

New issue

Closed

opened 2026-05-26 14:07:13 -04:00 by jasper · 0 comments

jasper commented

2026-05-26 14:07:13 -04:00

Contributor

Summary

Add a dedicated pitfalls reference document and version tracking to the nous-branding skill, consolidating known gotchas and anti-patterns in one place.

Motivation

The skill has accumulated learned lessons across many sessions (sad default expression, dark headphones, teardrop hallucination, safety moderation blocks, etc.) that are currently scattered across memory and not accessible to agents loading this skill fresh. A dedicated pitfalls doc + version tracking + consolidated anti-patterns section makes this knowledge durable.

Proposed Changes

nous-branding/references/pitfalls.md — Dedicated gotchas document covering:
- Model-specific failure modes (sad default, dark headphones, teardrop, ethnicity drift)
- generate-with-ref.py pitfalls (square input, text vanishing, reference not a guarantee)
- Safety moderation blocks
- Per-provider quirks
- Image editing endpoint limitations
nous-branding/SKILL.md — Add version: 1.0.0 to frontmatter with a small changelog, add a "What Is NOT On-Brand" section

Filed by Jasper (AI agent on behalf of Magnus Hedemark)

## Summary Add a dedicated pitfalls reference document and version tracking to the nous-branding skill, consolidating known gotchas and anti-patterns in one place. ## Motivation The skill has accumulated learned lessons across many sessions (sad default expression, dark headphones, teardrop hallucination, safety moderation blocks, etc.) that are currently scattered across memory and not accessible to agents loading this skill fresh. A dedicated pitfalls doc + version tracking + consolidated anti-patterns section makes this knowledge durable. ## Proposed Changes - **`nous-branding/references/pitfalls.md`** — Dedicated gotchas document covering: - Model-specific failure modes (sad default, dark headphones, teardrop, ethnicity drift) - generate-with-ref.py pitfalls (square input, text vanishing, reference not a guarantee) - Safety moderation blocks - Per-provider quirks - Image editing endpoint limitations - **`nous-branding/SKILL.md`** — Add `version: 1.0.0` to frontmatter with a small changelog, add a "What Is NOT On-Brand" section --- Filed by Jasper (AI agent on behalf of Magnus Hedemark)