diff --git a/README.md b/README.md index 029d894..a6dae49 100644 --- a/README.md +++ b/README.md @@ -119,7 +119,8 @@ SoulStack comes from [ProxySoul](https://proxysoul.com), the creator of [Empryo]

marketing

- Distilled from public LLM Gateway work: turn product evidence and authorized analytics into positioning, launches and measurable learning. Keep claims current, distinguish observation from attribution, and keep reports, slides and videos aligned without exposing private data. + Distilled from public LLM Gateway work: turn product evidence and authorized analytics into positioning, launches and measurable learning. Keep claims current, distinguish observation from attribution, and keep reports, slides and videos aligned without exposing private data.

+ Contributed by Ismail Ghallou diff --git a/design_system/components.md b/design_system/components.md index 28ae402..60a7123 100644 --- a/design_system/components.md +++ b/design_system/components.md @@ -13,6 +13,7 @@ | World swatch | `.swatch` | Night and day halves with the world's logo and colour dots; clicking switches the page | | Takeaway | `.take` | Icon well, a title of three words or fewer, one line | | Verb | `.verb` | A `soulstack` subcommand in pigment and what it does | +| Credit | `.lv-by`, `.doc-by` | A contributor's round avatar and "Contributed by **Name**" in a hairline pill, linking to their GitHub. Avatars live in `site/public/contributors/`; authors are listed once in `site/src/contributors.ts` | Icons are Lucide-style strokes at 1.75 (`site/src/icons.ts`). Add new ones there; never mix icon sets. diff --git a/site/public/contributors/smakosh.jpg b/site/public/contributors/smakosh.jpg new file mode 100644 index 0000000..837e543 Binary files /dev/null and b/site/public/contributors/smakosh.jpg differ diff --git a/site/scripts/build-docs.ts b/site/scripts/build-docs.ts index 5ff1e55..10520e2 100644 --- a/site/scripts/build-docs.ts +++ b/site/scripts/build-docs.ts @@ -2,6 +2,7 @@ import { mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from "nod import { basename, dirname, join } from "node:path"; import { marked } from "marked"; import { icon } from "../src/icons"; +import { SKILL_AUTHORS, avatarPath, profileUrl } from "../src/contributors"; const COPY_BUTTON = ``; @@ -84,6 +85,12 @@ pages.push({ body: readFileSync(join(repo, "guides", "mote-mascot.md"), "utf8").replace(/

[\s\S]*?<\/p>\n?/g, "").replace(/\n?/g, ""), }); +function credit(skill: string): string { + const by = SKILL_AUTHORS[skill]; + if (!by) return ""; + return `

Contributed by ${by.name}

\n\n`; +} + for (const name of readdirSync(join(repo, "skills"))) { const { meta, body } = frontmatter(readFileSync(join(repo, "skills", name, "SKILL.md"), "utf8")); pages.push({ @@ -92,7 +99,9 @@ for (const name of readdirSync(join(repo, "skills"))) { summary: meta.description ?? "", group: "Skills", order: 20, - body: body.replace(/\]\((reference\/[^)]+)\)/g, `](https://github.com/proxysoul/SoulStack/blob/main/skills/${name}/$1)`), + body: body + .replace(/^(#\s.+\n)/, (title) => `${title}\n${credit(name)}`) + .replace(/\]\((reference\/[^)]+)\)/g, `](https://github.com/proxysoul/SoulStack/blob/main/skills/${name}/$1)`), }); } diff --git a/site/src/content.ts b/site/src/content.ts index ff47431..00f8be6 100644 --- a/site/src/content.ts +++ b/site/src/content.ts @@ -1,3 +1,4 @@ +import { SKILL_AUTHORS, type Contributor } from "./contributors"; interface Palette { paper: string; ink: string; @@ -34,6 +35,7 @@ export const WORLDS: World[] = [ interface LayerItem { name: string; what: string; + by?: Contributor; } interface Layer { @@ -67,7 +69,7 @@ export const LAYERS: Layer[] = [ items: [ { name: "ensoul", what: "Builds a design system with worlds, modes, logos and screenshots, then redesigns the site." }, { name: "immune-system", what: "Drives the real product everywhere and remembers every bug." }, - { name: "marketing", what: "Turns product evidence into positioning, launches and measured learning." }, + { name: "marketing", what: "Turns product evidence into positioning, launches and measured learning.", by: SKILL_AUTHORS.marketing }, ], where: "Linked into ~/.agents/skills and ~/.claude/skills, so updates arrive with the stack.", }, diff --git a/site/src/contributors.ts b/site/src/contributors.ts new file mode 100644 index 0000000..2fc1211 --- /dev/null +++ b/site/src/contributors.ts @@ -0,0 +1,11 @@ +export interface Contributor { + name: string; + github: string; +} + +export const SKILL_AUTHORS: Record = { + marketing: { name: "Ismail Ghallou", github: "smakosh" }, +}; + +export const profileUrl = (c: Contributor) => `https://github.com/${c.github}`; +export const avatarPath = (c: Contributor) => `/contributors/${c.github}.jpg`; diff --git a/site/src/docs.css b/site/src/docs.css index fdf52f0..30504e8 100644 --- a/site/src/docs.css +++ b/site/src/docs.css @@ -187,6 +187,35 @@ border-radius: 12px; } +.prose .doc-by a { + display: inline-flex; + align-items: center; + gap: var(--s-2); + padding: 4px 12px 4px 4px; + border: 1px solid var(--rule-soft); + border-radius: 999px; + color: var(--ink-faint); + font-size: var(--t-small); + text-decoration: none; + transition: border-color 0.2s, color 0.2s; +} + +.prose .doc-by a:hover, +.prose .doc-by a:focus-visible { + border-color: var(--pigment); + color: var(--ink-soft); +} + +.prose .doc-by img { + width: 24px; + height: 24px; + border-radius: 50%; +} + +.prose .doc-by b { + color: var(--ink); +} + .docs-picker > summary { display: none; } diff --git a/site/src/pages/Home.tsx b/site/src/pages/Home.tsx index 2c87e51..ee2e53b 100644 --- a/site/src/pages/Home.tsx +++ b/site/src/pages/Home.tsx @@ -6,6 +6,7 @@ import { usePageMeta } from "../app/Chrome"; import { AGENTS, BEST, HOSTS, LAYERS, MACHINE, TAKEAWAYS, TERMINAL, WORLDS } from "../content"; import { startScene } from "../scene"; import { LOGO, pickWorld, useWorld } from "../world"; +import { avatarPath, profileUrl } from "../contributors"; const INSTALL = [ { id: "unix", icon: "apple", label: "macOS ยท Linux", cmd: "curl -fsSL https://raw.githubusercontent.com/proxysoul/SoulStack/main/scripts/setup.sh | sh" }, @@ -201,6 +202,14 @@ function Layers() {
{i.name}

{i.what}

+ {i.by && ( + + + + Contributed by {i.by.name} + + + )}
))} diff --git a/site/src/site.css b/site/src/site.css index 169c7a7..e1e6cdc 100644 --- a/site/src/site.css +++ b/site/src/site.css @@ -633,6 +633,37 @@ code { font-size: var(--t-small); } +.lv-by { + display: inline-flex; + align-items: center; + gap: var(--s-2); + margin-top: var(--s-2); + padding: 3px 10px 3px 3px; + border: 1px solid var(--rule-soft); + border-radius: 999px; + color: var(--ink-faint); + font-size: var(--t-small); + text-decoration: none; + transition: border-color 0.2s, color 0.2s; +} + +.lv-by:hover, +.lv-by:focus-visible { + border-color: var(--pigment); + color: var(--ink-soft); +} + +.lv-by img { + width: 20px; + height: 20px; + border-radius: 50%; +} + +.lv-by b { + color: var(--ink); + font-weight: 600; +} + .lv-dot { width: 8px; height: 8px;