Przejdź do treści
Biblioteka skilli
Programowanie · Nauka i wyjaśnianie

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.

Repozytorium
protowiki ↗
Licencja
LGPL
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
2
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

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

what is ProtoWikihow does this repo work
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

  1. What this repo is
  2. Tech stack
  3. Where things live
  4. What to do next
  5. Local dev
Sekcje z nagłówków SKILL.md, w oryginale · 94 linii, 611 słów
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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.