| name | portfolio-site-management |
| description | Maintain rcarmo.github.io thoroughly: content, icons, diagrams, favicon, build, rebuild/tag/push workflow, and client-side sorting/related behavior. |
Portfolio Site Management
Manage the projects/rcarmo.github.io portfolio site thoroughly and safely.
Scope
This skill applies when working on:
- project metadata under
_content/*.md
- generated pages (
index.html, projects/*.html)
- site generator logic in
build.ts
- client-side behavior in
assets/js/repo-island.mjs
- styles in
assets/css/style.css
- icons, logos, favicon, banners, and diagrams under
assets/
- release/tag/publish workflow for the site
Canonical files
Read these before making non-trivial changes:
build.ts
assets/js/repo-island.mjs
assets/css/style.css
.github/workflows/build.yml
- relevant
_content/<project>.md files
Site model
_content/*.md is the source of truth for project metadata and page content.
build.ts generates:
index.html
projects/*.html
- Live GitHub metadata is filled in client-side by
assets/js/repo-island.mjs.
- Do not hand-edit generated HTML unless debugging temporarily; persist real fixes in source files.
Working rules