Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -119,7 +119,8 @@ SoulStack comes from [ProxySoul](https://proxysoul.com), the creator of [Empryo]
<tr>
<td colspan="2" valign="top">
<h3><a href="skills/marketing/SKILL.md">marketing</a></h3>
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.<br><br>
<a href="https://github.com/smakosh"><img src="site/public/contributors/smakosh.jpg" width="20" height="20" alt=""></a> Contributed by <a href="https://github.com/smakosh">Ismail Ghallou</a>
</td>
</tr>
<tr>
Expand Down
1 change: 1 addition & 0 deletions design_system/components.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Binary file added site/public/contributors/smakosh.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
11 changes: 10 additions & 1 deletion site/scripts/build-docs.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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 = `<button type="button" class="copy docs-copy" aria-label="Copy" data-copy><span class="when-idle">${icon("copy")}</span><span class="when-done">${icon("check")}</span></button>`;

Expand Down Expand Up @@ -84,6 +85,12 @@ pages.push({
body: readFileSync(join(repo, "guides", "mote-mascot.md"), "utf8").replace(/<p align="center">[\s\S]*?<\/p>\n?/g, "").replace(/<p[\s\S]*?<\/p>\n?/g, ""),
});

function credit(skill: string): string {
const by = SKILL_AUTHORS[skill];
if (!by) return "";
return `<p class="doc-by"><a href="${profileUrl(by)}"><img src="${avatarPath(by)}" alt="" width="24" height="24" /><span>Contributed by <b>${by.name}</b></span></a></p>\n\n`;
}

for (const name of readdirSync(join(repo, "skills"))) {
const { meta, body } = frontmatter(readFileSync(join(repo, "skills", name, "SKILL.md"), "utf8"));
pages.push({
Expand All @@ -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)`),
});
}

Expand Down
4 changes: 3 additions & 1 deletion site/src/content.ts
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@
import { SKILL_AUTHORS, type Contributor } from "./contributors";
interface Palette {
paper: string;
ink: string;
Expand Down Expand Up @@ -34,6 +35,7 @@ export const WORLDS: World[] = [
interface LayerItem {
name: string;
what: string;
by?: Contributor;
}

interface Layer {
Expand Down Expand Up @@ -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.",
},
Expand Down
11 changes: 11 additions & 0 deletions site/src/contributors.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
export interface Contributor {
name: string;
github: string;
}

export const SKILL_AUTHORS: Record<string, Contributor> = {
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`;
29 changes: 29 additions & 0 deletions site/src/docs.css
Original file line number Diff line number Diff line change
Expand Up @@ -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;
}
Expand Down
9 changes: 9 additions & 0 deletions site/src/pages/Home.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -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" },
Expand Down Expand Up @@ -201,6 +202,14 @@ function Layers() {
<div>
<b>{i.name}</b>
<p>{i.what}</p>
{i.by && (
<a className="lv-by" href={profileUrl(i.by)} rel="noopener">
<img src={avatarPath(i.by)} alt="" width="20" height="20" loading="lazy" />
<span>
Contributed by <b>{i.by.name}</b>
</span>
</a>
)}
</div>
</li>
))}
Expand Down
31 changes: 31 additions & 0 deletions site/src/site.css
Original file line number Diff line number Diff line change
Expand Up @@ -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;
Expand Down
Loading