bigstep-branding
Skill1 starsChanged 3 months agoMITView on GitHub
Apply BigStep Technologies' full visual identity to any deliverable Claude produces — Word documents, PowerPoint decks, PDFs, spreadsheets, and HTML/web. Use this skill WHENEVER you create a document, presentation, report, proposal, profile, case study, one-pager, or any client- or internal-facing artifact for BigStep, even if the user doesn't say "branding". This is a complete design system, not a logo stamp: it ships the exact brand typeface (Poppins, the font used in BigStep's deck and site), the exact palette, the logo in three variants, and ReportLab/Office primitives for the brand's design language — concentric-ring cover motif, two-tone titles with cyan underlines, stat cards, callout panels, section dividers, branded tables, and consistent header/footer bands. Also use when asked to "make it on-brand", "add our logo/template", "use our colours/fonts", or to restyle an existing file to look premium and CEO-ready.
In this repository4 other files it gives its agents.
- handoffSkill
- open-prSkill
- start-ticketSkill
- tech-docSkill
The file
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 1 is distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 47
Designed components, not paragraphs: Use stat cards, callout panels (rounded, tinted, colored left rule), label chips, and branded tables …
- Distinctive: line 127
Use it for the document; use this skill for the design layer around it.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
BigStep Branding — Design System
This skill makes BigStep deliverables look like they came from one studio:
premium, consistent, and unmistakably BigStep. It is a design system, not a
logo-on-text layer. Pair it with the format skill (docx, pptx, pdf,
xlsx, frontend-design) for mechanics; this supplies the brand layer.
The non-negotiables (what makes it BigStep)
- Poppins everywhere. Poppins is the brand typeface (it's literally the
font embedded in the corporate deck). The six weights ship in
assets/fonts/. In Office formats (docx/pptx) use the SINGLE family "Poppins" + bold for weight (weight-named families like "Poppins SemiBold" don’t resolve in Word and fall back). In PDF the module registers each weight as a real embedded TTF. Never substitute another face. Keep the design FLAT — no drop shadows in any format. - Two-tone titles — lead word(s) Deep Navy
#041342, emphasis phrase BigStep Blue#1C62EC, with a short cyan underline beneath. White on blue/dark surfaces. - Blue-only. The whole system is blue / navy / cyan + neutrals. NEVER use
purple or lavender. Panels & zebra rows use the two BLUE tints
#E4F2FFand#D4E6FF. - No grey header line. Interior page headers use a short blue accent segment only. The full-width grey/tint rule is removed.
- The blue + rings system. Covers, section dividers and closing pages are
full-bleed
#1C62ECwith the faint concentric-ring motif in a corner and the white logo. Interior pages are white with a header band (logo + accent rule) and a footer (mark +www.bigsteptech.com+ page no.). - Designed components, not paragraphs. Use stat cards, callout panels
(rounded, tinted, colored left rule), label chips, and branded tables
(blue header row, blue
#D4E6FFzebra) — see the primitives below. - Logo on every page/slide, every format. Color on light, white on dark, mark for tight spots.
- Bullets are body text. List items use the same Poppins Regular / slate / 10–11pt as body copy. They are NEVER bold or emphasised. Only component titles (callout title, card title, table header) may be bold.
- Embed the font in Word. Poppins falls back to Calibri in Word if not
installed, so .docx output embeds the TTFs (see
scripts/embed_fonts.py). PDF embeds fonts inherently; pptx/xlsx rely on the bundled TTFs being installed (Calibri fallback).
How to build (PDF — full design control)
scripts/bigstep_brand.py is the engine. It exposes the palette, fonts, logo
loader, and ReportLab primitives.
import sys; sys.path.insert(0, "<skill>/scripts")
import bigstep_brand as bs
bs.register_fonts() # registers Poppins with ReportLab
from reportlab.pdfgen import canvas
from reportlab.lib.pagesizes import A4
c = canvas.Canvas("out.pdf", pagesize=A4); PW, PH = A4
bs.cover_page(c, PW, PH, title="...", subtitle="...", kicker="...",
footer_chips=["AI & Gen AI", "Product Engineering", ...]); c.showPage()
bs.page_frame(c, PW, PH, page_no=2, header_label="Executive Summary")
bs.two_tone(c, 18*bs.mm, PH-42*bs.mm, "Executive ", "Summary", size=22)
bs.stat_card(c, x, y, w, h, "700+", "Apps & solutions shipped")
bs.callout(c, x, y, w, "Squad-as-a-Service", ["..."], fill=bs.C.TINT)
# branded table: Table(...).setStyle(bs.branded_table_style())
bs.section_divider(c, PW, PH, 1, "Engagement Snapshot"); c.showPage()
bs.closing_page(c, PW, PH, ["Let's build", "your next big step."],
contact={"title":"Contact Us","lines":[...]}) # accent ABOVE title
c.save()Always use bs.draw_logo(...) for logos in ReportLab — never bare
drawImage with only a width (it mis-positions the image; the helper passes
explicit width+height and flattens transparency so it always renders).
A complete, working reference deck is in examples/sample_pdf.py — read it
first; it composes every primitive into a CEO-ready document.
How to build (PowerPoint & Word)
Slides and docs use the same palette, fonts, logo, two-tone titles, stat cards, callout panels, and branded tables — rebuilt with native shapes/tables. Working, rendered references:
examples/sample_pptx.py— cover, content (stat cards + callout), closing.examples/sample_docx.py— header band, stat cards, callout, branded table.
Set fonts to the family name Poppins (install assets/fonts/*.ttf on the
machine that opens the file) with Calibri as the only fallback. Detailed
recipes: references/pptx_branding.md, references/docx_branding.md,
references/pdf_branding.md.
Reference files
references/brand_guidelines.md— canonical palette, type scale, logo rules, component specs, voice. Read this first.references/{pdf,pptx,docx,xlsx}_branding.md— per-format recipes + checklists.
Palette (exact, sampled from the deck)
#1C62EC primary blue · #0F3FA6 deep blue (depth) · #3FC7F2 cyan accent ·
#041342 heading navy · #2B3D4F body slate · #E4F2FF light tint ·
#D4E6FF blue tint 2 (zebra) · #FDCA0E gold (rare) · #FFFFFF white · #6B7A8D muted.
Assets
assets/bigstep_logo_color.png/_white.png/bigstep_mark.pngassets/fonts/Poppins-*.ttf(+OFL.txtlicense)
Companion skill
tech-doc builds a technical documentation deliverable end to end — the section outline, the
evidence rules, and a markdown → branded DOCX → PDF pipeline that already carries these styles.
Use it for the document; use this skill for the design layer around it.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

