affaan-m/ECC

brand-discovery

Use when a brand needs to discover or articulate its identity through structured multi-session interviews. Covers purpose, positioning, audience, personality, voice, narrative, and founder-brand tension across 8 modules using laddering, 5 Whys, and projective techniques. Produces a resumable session with disk-persisted state and a master brandbook (90_SYNTHESIS.md).

69CollectingReads filesWrites files
See how to use itView GitHub source
npx skills add https://github.com/affaan-m/ECC --skill "skills/brand-discovery"
Automated source guideContent productionDeep source

Source checked Jul 28, 2026·Refresh due Oct 26, 2026

Reorganized from the pinned upstream SKILL.md

Source-grounded content guide: brand-discovery

Use this skill to conduct a structured, adaptive brand identity interview. The goal is a complete 90SYNTHESIS.md — a master brandbook the organization can use to brief designers, writers, and external collaborators.

npx skills add https://github.com/affaan-m/ECC --skill "skills/brand-discovery"
Check the pinned source

The pinned source contains enough sections and task detail for a source-grounded deep guide; automated content is still not an independent test.

946 source words · 8 usable sections

Best fit

  • Use when a brand needs to discover or articulate its identity through structured multi-session interviews.

Content workflow

Read brand-discovery through these 5 source sections

Sections are extracted automatically from the pinned SKILL.md and link back to the source.

01

When to Activate

A brand is being created, repositioned, or needs a written identity reference to brief collaborators.

SKILL.md · When to Activate
A brand is being created, repositioned, or needs a written identity reference to brief collaborators.Multiple sessions are expected — the conversation will span days or weeks.Multiple founders or stakeholders need individual interviews before a reconciliation pass.
02

Session start protocol

On every activation, perform these steps before asking any interview question:

SKILL.md · Session start protocol
Check for prior progress. Look for an existing set of module filesRead the current module file if one is in progress, and scan its RawReport to the user in two or three sentences: which module we are
03

Interview discipline

Apply these rules throughout every module:

SKILL.md · Interview discipline
One question at a time. Never present a list of questions.After each answer: short paraphrase → one deepening probe OR closeLaddering: for every "what" answer, follow with "Why does that
04

Module sequence

Complete modules in order. Honour a user request to jump modules and note the skip in state.json.

SKILL.md · Module sequence
Complete modules in order. Honour a user request to jump modules and note the skip in state.json.
05

State write protocol

After each module reaches saturation or done status, write two files:

SKILL.md · State write protocol
After each module reaches saturation or done status, write two files:Module file at modules/{moduleFile} — full Raw and Synthesis content.state.json — a lightweight checkpoint so a later session can resume. Update completedModules, inProgressModule, nextModule, lastUpdated. Schema:

SkillSignal prompt templates

Provide the task, context, and acceptance criteria

These prompts were written by SkillSignal from the source structure; they are not upstream text.

Source-grounded prompt

Use for a content task while explicitly checking the source sections.

Use brand-discovery for this content task: [task]. Inputs and constraints: [details]. Work through these pinned SKILL.md sections: “When to Activate”, “Session start protocol”, “Interview discipline”, “Module sequence”, “State write protocol”. Cite the concrete requirements that shape each step, do not invent capabilities absent from the source, and verify the result against: [acceptance criteria].

Content checklist

Verify each item before delivery

The source section “When to Activate” has been checked.

The source section “Session start protocol” has been checked.

The source section “Interview discipline” has been checked.

The source section “Module sequence” has been checked.

Static permission evidence

Inspect the exact source lines that triggered a signal

These are source excerpts matched by deterministic rules, not findings of malicious behavior, safety, or actual execution.

Choose a different workflow

When another Skill is the better fit

design-intelligence

Grounded design brief from the adopted corpus — style, WCAG-checked color tokens, typography, layout pattern, anti-patterns. Use on ui-design-brief or any which-style/palette/font/chart decision.

A separate implementation from event4u-app/agent-config; compare its source, maintenance signals, and permission requirements.

Open source detail

higgsfield-generate

Use when the user wants to generate an image or video via Higgsfield AI. Covers 30+ models: Soul V2, Seedance 2.0, Kling 3.0, Veo 3.1, GPT Image 2, Nano Banana 2. Also covers Marketing Studio — branded ad video/image with avatars and products. Use whenever: "generate an image", "make a video", "animate this photo", "image-to-video", "img2vid", "edit this image with AI", "produce a clip", "create an ad", "make a UGC video", "marketing video", "brand video", "TV spot", "import product from URL", "

A separate implementation from MoizIbnYousaf/marketing-cli; compare its source, maintenance signals, and permission requirements.

Open source detail

create-skill

Create new marketing skills for the mktg playbook. Use when the agent needs to add a new capability, someone says 'create a skill', 'new skill', 'add a marketing skill', 'extend the playbook', 'I need a skill for X', 'build a skill', 'make a skill for Y', or 'add capability for Z'. Also use when someone wants to capture a marketing workflow they just did into a reusable skill, or when they say 'turn this into a skill'. Reads the skill contract, generates SKILL.md with correct frontmatter and str

A separate implementation from MoizIbnYousaf/marketing-cli; compare its source, maintenance signals, and permission requirements.

Open source detail

FAQ

What does the brand-discovery source document cover?

Use this skill to conduct a structured, adaptive brand identity interview. The goal is a complete 90SYNTHESIS.md — a master brandbook the organization can use to brief designers, writers, and external collaborators.

How do I install brand-discovery?

The source record exposes this install command: npx skills add https://github.com/affaan-m/ECC --skill "skills/brand-discovery". Inspect the command and pinned source before running it.

Which permission-related actions were detected?

Static rules flagged read-files, write-files in the source; the page lists the matching lines and excerpts.

Repository stars
234,327
Repository forks
35,711
Quality
69/100
Source repository last pushed

Quality breakdown

Based on traceable docs and repository signals; stars are not treated as quality.

69/100
Documentation26/30
Specificity14/25
Maintenance18/20
Trust signals11/25

Compare before choosing

Related Agent Skills and source variants

These links are selected from shared tasks, functions, stacks, platforms, and same-name variants. Compare the source owner, documentation, permissions, and maintenance signals.

design-intelligence by event4u-app

Grounded design brief from the adopted corpus — style, WCAG-checked color tokens, typography, layout pattern, anti-patterns. Use on ui-design-brief or any which-style/palette/font/chart decision.

higgsfield-generate by MoizIbnYousaf

Use when the user wants to generate an image or video via Higgsfield AI. Covers 30+ models: Soul V2, Seedance 2.0, Kling 3.0, Veo 3.1, GPT Image 2, Nano Banana 2. Also covers Marketing Studio — branded ad video/image with avatars and products. Use whenever: "generate an image", "make a video", "animate this photo", "image-to-video", "img2vid", "edit this image with AI", "produce a clip", "create an ad", "make a UGC video", "marketing video", "brand video", "TV spot", "import product from URL", "

create-skill by MoizIbnYousaf

Create new marketing skills for the mktg playbook. Use when the agent needs to add a new capability, someone says 'create a skill', 'new skill', 'add a marketing skill', 'extend the playbook', 'I need a skill for X', 'build a skill', 'make a skill for Y', or 'add capability for Z'. Also use when someone wants to capture a marketing workflow they just did into a reusable skill, or when they say 'turn this into a skill'. Reads the skill contract, generates SKILL.md with correct frontmatter and str

creative by MoizIbnYousaf

Generate visual asset briefs, ad copy variants, AI image prompts, video scripts, and storyboards. Full creative production system with 5 specialized modes: product photos, product video, social graphics, talking heads, and ad creative. Make sure to use this skill whenever the user mentions any visual or creative marketing need — ad creative, image prompts, video scripts, thumbnails, banners, social graphics, product photography, storyboards, or marketing visuals of any kind. Even if they just sa

site-architecture by coreyhaines31

When the user wants to plan, map, or restructure their website's page hierarchy, navigation, URL structure, or internal linking. Also use when the user mentions "sitemap," "site map," "visual sitemap," "site structure," "page hierarchy," "information architecture," "IA," "navigation design," "URL structure," "breadcrumbs," "internal linking strategy," "website planning," "what pages do I need," "how should I organize my site," or "site navigation." Use this whenever someone is planning what page

View original Skill.mdThis page is parsed directly from the repository SKILL.md without editorial rewriting. Collected: Jul 28, 2026 · about 5 min

Brand Discovery

Use this skill to conduct a structured, adaptive brand identity interview. The goal is a complete 90_SYNTHESIS.md — a master brandbook the organization can use to brief designers, writers, and external collaborators.

The interview runs across multiple sessions. Capture answers to disk as you go so that no elicited knowledge is lost when a conversation ends, and so a later session can resume from where the last one stopped.

When to Activate

  • A brand is being created, repositioned, or needs a written identity reference to brief collaborators.
  • Multiple sessions are expected — the conversation will span days or weeks.
  • Multiple founders or stakeholders need individual interviews before a reconciliation pass.
  • The user wants a structured, repeatable method rather than an ad-hoc chat.
  • Existing brand documentation is scattered, implicit, or founder-dependent and needs to be made explicit.

Session start protocol

On every activation, perform these steps before asking any interview question:

  1. Check for prior progress. Look for an existing set of module files and a state.json checkpoint in the project's brand-identity directory. If none exists, this is a fresh start — confirm the brand name, participants, and where to save the brand-identity files, then begin at the first module.
  2. Read the current module file if one is in progress, and scan its Raw section for previously captured answers.
  3. Report to the user in two or three sentences: which module we are in, its status, and what remains. Then ask: "Continue here, or switch module?"

Interview discipline

Apply these rules throughout every module:

  1. One question at a time. Never present a list of questions.
  2. After each answer: short paraphrase → one deepening probe OR close the thread if the topic is saturated. Never move on silently.
  3. Laddering: for every "what" answer, follow with "Why does that matter to you?" until a core value surfaces (typically two to four iterations).
  4. 5 Whys: for beliefs or positioning claims — push until the root reason, not the surface declaration, is on the table.
  5. Detect thin answers: if generic, jargon-heavy, or vague, ask for one concrete example, a client story, or a number.
  6. Projective techniques (use once per module to break a plateau):
    • "If the brand were a person, how would they walk into a room?"
    • Brand obituary: "If the organization closed in five years, what would customers miss? What would you regret not having said?"
    • Competitive contrast: "Name one peer you admire but would never want to become. What specifically makes them the wrong model?"
  7. Saturation signal: when two consecutive probes produce no new information, summarise and close the module.
  8. End of module: write a structured module file with two sections:
    • ## Raw — verbatim quotes and examples.
    • ## Synthesis — your interpretation, three candidate formulations, open questions, contradictions between participants. Then update the state.json checkpoint (see State protocol below).

Module sequence

FileLabelFrameworks used
10_purpose-why.mdPurpose / WhySinek Golden Circle, Lencioni
20_positioning.mdPositioningDunford "Obviously Awesome", Moore template
30_audience-niche.mdAudience & NicheBaker "Business of Expertise", ICP
40_personality-archetype.mdPersonality & ArchetypeMark & Pearson 12 archetypes, J. Aaker 5 dims
50_voice-tone.mdVoice & ToneBrand voice guidelines
60_narrative-story.mdNarrative / StoryNeumeier trueline, brand story arc
70_founder-tension.mdFounder Brands vs Studio BrandEnns "Win Without Pitching"
90_SYNTHESIS.mdMaster BrandbookKapferer prism, Aaker brand system

Complete modules in order. Honour a user request to jump modules and note the skip in state.json.

State write protocol

After each module reaches saturation or done status, write two files:

Module file at modules/{moduleFile} — full Raw and Synthesis content.

state.json — a lightweight checkpoint so a later session can resume. Update completedModules, inProgressModule, nextModule, lastUpdated. Schema:

{
  "session": "{brand_name}-brand-{YYYY-MM}",
  "outputPath": "{path_to_brand_identity_directory}",
  "completedModules": [],
  "inProgressModule": "10_purpose-why.md",
  "nextModule": "20_positioning.md",
  "participants": ["founder-A"],
  "lastUpdated": "{ISO-8601}"
}

After writing, confirm: "Module X saved. State updated. Next: Y."

Terminal module (90_SYNTHESIS.md): when writing the final synthesis, set inProgressModule to "90_SYNTHESIS.md" and nextModule to null in state.json. After writing, set completedModules to include "90_SYNTHESIS.md", then set inProgressModule to null — leaving it populated would cause a future resumption to treat the completed brandbook as still in progress. Confirm: "Brandbook complete. All modules saved."

Multi-founder mode

When more than one founder participates, write each founder's answers to founders/{participant}.md instead of the main module files. Validate the participant name before writing: accept only alphanumeric characters and hyphens (e.g. founder-a, anna); reject names containing path separators (/, \, ..) or special characters. Validate moduleFile against the enumerated module sequence (10 through 90 only). Validate outputPath to ensure it is an absolute path within the project directory — reject relative paths and paths that escape via .. segments. After all founders complete a module, run a reconciliation pass: summarise convergences and divergences in the module file, flag "productive tensions" for the group alignment workshop.

Anti-Patterns

  • Starting without reading state first. Every session must open by checking for existing module files and state.json. Skipping this loses all continuity from prior sessions.
  • Asking multiple questions at once. One question at a time is not optional — lists produce checklist answers, not real insight.
  • Moving to Synthesis before saturation. If the last two probes produced no new information, the module is done. If they did — it isn't.
  • Skipping multi-founder reconciliation. When multiple stakeholders are involved, individual interviews must complete before reconciliation. Discussing the brand collectively first introduces anchoring bias.
  • Treating this as a one-shot session. This skill is designed for multiple sessions. Rushing to 90_SYNTHESIS.md in one conversation produces shallow output.

Related Skills

  • competitive-platform-analysis — after brand-discovery establishes the positioning brief, use this to scope and categorise the competitor set.
  • brand-voice (ECC) — if the brand-discovery voice-and-tone module needs a separate, source-derived writing-style profile.
Source repo
affaan-m/ECC
Skill path
skills/brand-discovery/SKILL.md
Commit SHA
4e973d3eaf92
Repository license
MIT
Data collected