protowiki-getting-started
/protowiki-getting-started
Wprowadza w repozytorium ProtoWiki: stos Vite, Vue 3, Codex i GitHub Pages, układ kodu i skilli oraz pierwszy krok dla nowej osoby lub agenta.
- Autor
- wikimedia ↗
- Repozytorium
- protowiki ↗
- Licencja
- LGPL
- Ostatnia zmiana repozytorium
- 26.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 2
Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.
LGPL, otwarta.
Co robi i kiedy
Wprowadza w repozytorium ProtoWiki: stos Vite, Vue 3, Codex i GitHub Pages, układ kodu i skilli oraz pierwszy krok dla nowej osoby lub agenta.
Wyzwalacze z opisu
Oryginalny opis (EN)
Orientation for the ProtoWiki repo — what it is, the Vite + Vue 3 + Codex + GitHub Pages stack, where code lives, where skills live, and the first thing to do. Use when first opening this repo, when asked "what is ProtoWiki" or "how does this repo work", or when an agent needs a high-level map before doing anything else.
Jak działa
- What this repo is
- Tech stack
- Where things live
- What to do next
- Local dev
Podgląd SKILL.md
--- name: protowiki-getting-started description: Orientation for the ProtoWiki repo — what it is, the Vite + Vue 3 + Codex + GitHub Pages stack, where code lives, where skills live, and the first thing to do. Use when first opening this repo, when asked "what is ProtoWiki" or "how does this repo work", or when an agent needs a high-level map before doing anything else. --- # ProtoWiki — getting started ## What this repo is ProtoWiki is a prototyping playground for Wikimedia features. It is **not** a CMS, not a real wiki, not a deployed product. It exists so that designers, PMs, and engineers can stand up a realistic-looking Wikipedia / MediaWiki prototype in minutes, hand it to a researcher, and link it from a Phabricator ticket — using the **same design system, the same fonts, and (optionally) the same real data** as production. Realism is the goal. The repo bundles: - The Wikimedia [Codex design system](https://doc.wikimedia.org/codex/) (Vue 3 components, CSS tokens, icons) so prototypes look right. - Data utilities that talk to the live Wikipedia REST and Action APIs. - Single-concern layout wrappers that paint each Wikipedia surface (chrome, article column, special-page shell, plain canvas) and compose by nesting — for the **website** and for the **iOS / Android apps**. - A skills system under `.agents/skills/` that documents every part of the repo for both humans and AI coding agents. For the full component catalogue, see [`protowiki-components`](../protowiki-components/SKILL.md). ## Tech stack - **Vite** + **Vue 3** (Composition API, `<script setup>`) - **TypeScript**, non-strict (`strict: false`, `allowJs: true`) — optional for prototype authors; editors get autocomplete without build errors - **`unplugin-vue-router`** — file-based routing under `src/prototypes/` - **`@wikimedia/codex`** + `@wikimedia/codex-design-tokens` + `@wikimedia/codex-icons` - Plain CSS (no preprocessor) - **Prettier** + **ESLint** - **GitHub Pages** for hosting (no server needed) ## Where things live ``` protowiki/ ├── src/ │ ├── main.ts ← Vue mount + boot-time skin/theme setup │ ├── App.vue ← thin shell (RouterView) │ ├── prototypes/ ← prototypes (each folder = one route) │ │ ├── index.vue ← home / gallery (auto-lists prototypes) │ │ ├── template-chrome/index.vue │ │ ├── template-dashboard/index.vue │ │ └── template-homepage/index.vue │ ├── components/ ← shipped components (wrappers, primitives, article, dashboard) │ ├── composables/ ← useSkin / useTheme (read-only hooks) │ ├── lib/ ← theming logic, helpers │ └── styles/ ← global.css, wiki-skins/, dark.css ├── .agents/skills/ ← skills for both humans and agents (see below) ├── AGENTS.md ← thin index pointing at the skills └── README.md ← human-friendly intro pointing at the same skills ``` There is **no** `.cursor/rules/`, **no** parallel `resources/` folder, **no** `CLAUDE.md`. All non-code material is a skill. Skills are markdown that humans read and that AI agents auto-discover. ## What to do next | If you want to… | Read… | | --- | --- | | Make a new prototype | [`protowiki-create-prototype`](../protowiki-create-prototype/SKILL.md) | | Prototype the iOS / Android apps rather than the website | [`protowiki-app-prototyping`](../protowiki-app-prototyping/SKILL.md) | | Customize home gallery listing | [`protowiki-create-prototype` → `gallery-meta.md`](../protowiki-create-prototype/references/gallery-meta.md) | | Look up a component (wrappers, article surfaces, search bar…) | [`protowiki-components`](../protowiki-components/SKILL.md) | | Build an article page (live vs hand-authored) | [`protowiki-components`](../protowiki-components/SKILL.md) — **`ArticleLive`** (default) or **`ArticleCustom`**; **`template-article/`**, **`example-custom-article/`** | | Use a Codex component, token, or icon | [`codex-usage`](../codex-usage/SKILL.md) | | Fetch real data from Wikipedia | [`wiki-apis`](../wiki-apis/SKILL.md) | | Snapshot article HTML + skin CSS into the repo (fixtures; copy markup into **`ArticleCustom`**) | [`protowiki-snapshot-data`](../protowiki-snapshot-data/SKILL.md) | | Prototype VisualEditor-style editing (article template, suggestion mode) | [`protowiki-components` → `editors.md`](../protowiki-components/references/editors.md) | | Make light/dark or desktop/mobile previews | [`protowiki-skins`](../protowiki-skins/SKILL.md) + [`protowiki-theme`](../protowiki-theme/SKILL.md) | | Deploy to GitHub Pages | [`protowiki-deploy`](../protowiki-deploy/SKILL.md) | ## Local dev ```bash npm install npm run dev # http://localhost:5173 — use this for prototyping ``` That's it — there's no registration step for new prototypes. Drop a folder under `src/prototypes/` and the route is live. Gallery **title** and **description** must not be AI-generated — ask the author or omit; see [`protowiki-create-prototype`](../protowiki-create-prototype/SKILL.md). CI runs `npm run build` when you push or open a PR; you only need a local build to debug GitHub Pages issues — see [`protowiki-deploy`](../protowiki-deploy/SKILL.md).
Wersje
W bazie nie ma innych skilli o nazwie protowiki-getting-started.
Migawka bazy z 13.11.2026 · wersja paczki d4417e65e52f (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100protowiki-deploy
Prowadzi przez budowanie i wdrażanie ProtoWiki na GitHub Pages: wdrożenie produkcyjne, podglądy pull requestów, ścieżka bazowa, fallback SPA i workflow CI. - 100protowiki-update-codex
Prowadzi przez aktualizację ProtoWiki do nowej wersji systemu projektowego Wikimedia Codex: wspólne podniesienie trzech pakietów, porównanie dokumentacji, poprawki w skillach i odświeżenie tokenów. - 90markstream-vue2-vite
Integruje markstream-vue2 z aplikacjami Vue 2 opartymi na Vite, w tym z importem workerów dla Mermaid i KaTeX. - 90vue-vite
Pomaga stawiać SPA w Vue, konfigurować Vite i Vue Router oraz pracować z Pinia w nowoczesnych projektach frontendowych. - 90vue-vite-typescript
Pomaga stawiać SPA w Vue z TypeScript, konfigurować Vite i Vue Router oraz pracować z Pinia w nowoczesnych projektach. - 100vite-development
Obsługuje narzędzie Vite 8.0.10: HMR, szybkie buildy, pluginy i zoptymalizowane zasoby produkcyjne, w projektach React i Vue.