magnus/agent-skills
1
1
Fork 0
Code Issues Pull requests Projects Releases 5 Packages Wiki Activity Actions

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

Merged
magnus merged 1 commit from feat/pitfalls-and-versioning into main 2026-05-26 14:10:41 -04:00
Conversation 0 Commits 1 Files changed 2 +220
jasper commented 2026-05-26 14:08:26 -04:00
Contributor
Copy link

Summary

Adds a dedicated pitfalls reference document and version tracking to the nous-branding skill, consolidating learned lessons across 6 categories of failure modes.

Changes

  • nous-branding/references/pitfalls.md — New reference document (~200 lines) covering:
    • Mascot generation failures (sad expression, dark headphones, teardrop, ethnicity, clothing)
    • Image editing / reference workflow pitfalls
    • Safety / moderation blocks
    • Provider-specific quirks (OpenAI edits, DALL-E 3, ComfyUI)
    • Prompt engineering anti-patterns
    • Pipeline / tooling gotchas
    • Quick-reference fix table for common problems
  • nous-branding/SKILL.md — Added version 1.1.0 to frontmatter, added comprehensive "What Is NOT On-Brand" section with anti-pattern table linking to pitfalls.md

Related Issue

Closes #37

Type of Change

  • ✨ New feature
  • 🐛 Bug fix
  • ♻️ Refactor
  • 📝 Documentation
  • 🧪 Test
  • 🔧 CI/CD

Checklist

  • pitfalls.md covers all known failure modes from accumulated usage sessions
  • Every gotcha includes symptom, cause, and fix
  • Quick-reference table for common problems at the end
  • Cross-linked from SKILL.md "What Is NOT On-Brand" section
  • Version bumped to 1.1.0

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

## Summary Adds a dedicated pitfalls reference document and version tracking to the nous-branding skill, consolidating learned lessons across 6 categories of failure modes. ## Changes - **`nous-branding/references/pitfalls.md`** — New reference document (~200 lines) covering: - Mascot generation failures (sad expression, dark headphones, teardrop, ethnicity, clothing) - Image editing / reference workflow pitfalls - Safety / moderation blocks - Provider-specific quirks (OpenAI edits, DALL-E 3, ComfyUI) - Prompt engineering anti-patterns - Pipeline / tooling gotchas - Quick-reference fix table for common problems - **`nous-branding/SKILL.md`** — Added version 1.1.0 to frontmatter, added comprehensive "What Is NOT On-Brand" section with anti-pattern table linking to pitfalls.md ## Related Issue Closes #37 ## Type of Change - [ ] ✨ New feature - [ ] 🐛 Bug fix - [ ] ♻️ Refactor - [x] 📝 Documentation - [ ] 🧪 Test - [ ] 🔧 CI/CD ## Checklist - [x] pitfalls.md covers all known failure modes from accumulated usage sessions - [x] Every gotcha includes symptom, cause, and fix - [x] Quick-reference table for common problems at the end - [x] Cross-linked from SKILL.md "What Is NOT On-Brand" section - [x] Version bumped to 1.1.0 --- Filed by Jasper (AI agent on behalf of Magnus Hedemark) 
Adds references/pitfalls.md cataloging known failure modes across
6 categories (mascot generation, image editing, safety, provider
quirks, prompt engineering, pipeline tooling) with a quick-reference
fix table.

Updates SKILL.md with version 1.1.0 in frontmatter and a consolidated
'What Is NOT On-Brand' section with anti-pattern table.

Closes #37

Signed-off-by: Magnus Hedemark <magnus919@pm.me>
magnus force-pushed feat/pitfalls-and-versioning from 13e16e3e1f to 9eca0ec761 2026-05-26 14:10:23 -04:00 Compare
magnus merged commit bd94249c88 into main 2026-05-26 14:10:41 -04:00
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels   
community-feedback
Originates from community review

  
enhancement
New feature or request

  
skill-upgrade
Skill enhancement or refactor

No labels
community-feedback
enhancement
skill-upgrade
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
magnus/agent-skills!38
No description provided.