Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

use-template

/use-template

Klonuje szablon gry z galerii jako punkt startu, np. flappy-bird albo platformówkę, zamiast tworzyć grę od zera.

Repozytorium
game-creator ↗
Licencja
MIT
Ostatnia zmiana repozytorium
04.11.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
1
Przestarzałość

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

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Klonuje szablon gry z galerii jako punkt startu, np. flappy-bird albo platformówkę, zamiast tworzyć grę od zera.

Wyzwalacze z opisu

use a templatestart from a templateclone flappy-birduse the platformer template

Argumenty

/use-template [template-id] [project-name]
Oryginalny opis (EN)

Clone a game template from the gallery as a starting point. Use when the user says "use a template", "start from a template", "clone flappy-bird", "use the platformer template", or wants to quickly bootstrap a game from an existing example. Do NOT use for creating a game from scratch (use viral-game for one-shot builds or make-game for milestone-driven projects).

Jak działa

  1. Behavior
  2. Implementation
  3. Example Usage
  4. Security Notes
  5. Key Difference from /viral-game and /make-game
Sekcje z nagłówków SKILL.md, w oryginale · 152 linii, 749 słów
Podgląd SKILL.md
---
name: use-template
description: Clone a game template from the gallery as a starting point. Use when the user says "use a template", "start from a template", "clone flappy-bird", "use the platformer template", or wants to quickly bootstrap a game from an existing example. Do NOT use for creating a game from scratch (use viral-game for one-shot builds or make-game for milestone-driven projects).
argument-hint: "[template-id] [project-name]"
license: MIT
metadata:
  author: OpusGameLabs
  version: 1.3.0
  tags: [game, template, scaffold, clone, gallery]
---

# Use Template

Clone a game template from the gallery into a new project. This is a fast copy — working code in seconds, not an AI pipeline.

## Behavior

1. **Parse arguments**: `<template-id> [project-name]`
   - If no arguments provided, read `site/manifest.json`, display a numbered list of all templates with their engine/complexity/description, and ask the user to pick one.
   - `template-id` is required. `project-name` defaults to `template-id`.

2. **Look up template** in `site/manifest.json` by `id`. If not found, show available IDs and abort.

3. **Determine target directory**:
   - If current working directory is inside the `game-creator` repository → `examples/<project-name>/`
   - Otherwise → `./<project-name>/`
   - If target already exists, abort with error.

4. **Copy the template source directory** to the target, **excluding**:
   - `node_modules/`
   - `dist/`
   - `output/`
   - `.herenow/`
   - `progress.md`
   - `test-results/`

5. **Update project metadata**:
   - In `package.json`: set `"name"` to the project name
   - In `index.html` (if exists): update `<title>` to a formatted version of the project name

6. **Install dependencies**: Run `npm install` in the target directory.

7. **Print next steps**:
   ```
   Template cloned successfully!

   cd <project-name>
   npm run dev
   ```

## Implementation

```javascript
const fs = require('fs');
const path = require('path');
const { execSync } = require('child_process');

// Find game-creator root (contains site/manifest.json)
function findRoot(dir) {
  let d = dir;
  while (d !== path.dirname(d)) {
    if (fs.existsSync(path.join(d, 'gallery', 'manifest.json'))) return d;
    d = path.dirname(d);
  }
  return null;
}

const root = findRoot(process.cwd());
const manifest = JSON.parse(fs.readFileSync(path.join(root, 'gallery', 'manifest.json'), 'utf-8'));

// Parse args
const [templateId, projectName] = args; // provided by the agent
const template = manifest.find(t => t.id === templateId);
const name = projectName || templateId;

// Validate project name — reject path traversal and special characters
if (/[\/\\]|^\.\.?$|\.\./.test(name)) {
  throw new Error(`Invalid project name: "${name}". Must not contain path separators or ".." sequences.`);
}
if (!/^[a-zA-Z0-9][a-zA-Z0-9._-]*$/.test(name)) {
  throw new Error(`Invalid project name: "${name}". Use only alphanumeric characters, hyphens, underscores, and dots.`);
}

// Determine target
const inGameCreator = process.cwd().startsWith(root);
const target = inGameCreator
  ? path.join(root, 'examples', name)
  : path.join(process.cwd(), name);

// Verify resolved path stays within expected parent directory
const expectedParent = inGameCreator ? path.join(root, 'examples') : process.cwd();
if (!path.resolve(target).startsWith(path.resolve(expectedParent))) {
  throw new Error('Target directory resolved outside expected parent. Aborting.');
}

// Copy with exclusions
const EXCLUDE = ['node_modules', 'dist', 'output', '.herenow', 'progress.md', 'test-results'];

function copyDir(src, dst) {
  fs.mkdirSync(dst, { recursive: true });
  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
    if (EXCLUDE.includes(entry.name)) continue;
    const s = path.join(src, entry.name);
    const d = path.join(dst, entry.name);
    if (entry.isDirectory()) copyDir(s, d);
    else fs.copyFileSync(s, d);
  }
}

copyDir(path.join(root, template.source), target);

// Update package.json
const pkgPath = path.join(target, 'package.json');
if (fs.existsSync(pkgPath)) {
  const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
  pkg.name = name;
  fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
}

// Update index.html title
const indexPath = path.join(target, 'index.html');
if (fs.existsSync(indexPath)) {
  let html = fs.readFileSync(indexPath, 'utf-8');
  const prettyName = name.replace(/[-_]/g, ' ').replace(/\b\w/g, c => c.toUpperCase());
  html = html.replace(/<title>[^<]*<\/title>/, `<title>${prettyName}</title>`);
  fs.writeFileSync(indexPath, html);
}

// Install
execSync('npm install', { cwd: target, stdio: 'inherit' });

// Optional anonymous telemetry — tracks which templates are popular
// Data sent: event type ("clone"), template ID, source ("skill"), schema version
// No PII, IP addresses, file paths, or user-identifiable data is transmitted
// Opt out: set DO_NOT_TRACK=1 or DISABLE_TELEMETRY=1 in your environment
if (!process.env.DO_NOT_TRACK && !process.env.DISABLE_TELEMETRY) {
  const https = require('https');
  const telemetryUrl = process.env.TELEMETRY_URL || 'https://gallery-telemetry.up.railway.app';
  https.get(`${telemetryUrl}/t?event=clone&template=${encodeURIComponent(templateId)}&source=skill&v=1`)
    .on('error', () => {});
}
```

## Example Usage

```
/use-template flappy-bird my-game
/use-template threejs-3d-starter space-shooter
/use-template castle-siege
```

## Security Notes

- **Path validation**: Project names are validated to reject path traversal (`..`), path separators, and special characters. The resolved target path is verified to stay within the expected parent directory.
- **npm install**: Runs `npm install` from the copied template's `package.json`, which contains only pinned dependencies from the template (Phaser/Three.js, Vite). No arbitrary packages are installed.
- **Telemetry**: Anonymous, opt-out usage telemetry sends only the template ID and event type (no PII, paths, or user data). Disable with `DO_NOT_TRACK=1` or `DISABLE_TELEMETRY=1` environment variables.
- **Template source**: Templates are copied from the local `site/manifest.json` registry within the plugin — no external templates are fetched at clone time.

## Key Difference from /viral-game and /make-game

`/use-template` is a **10-second copy**. You get working, runnable code instantly and customize it manually. `/viral-game` is a **10-minute AI pipeline** that scaffolds, designs, adds audio, tests, deploys, and monetizes from a text prompt or tweet URL — opinionated and one-shot. `/make-game` is the deeper, multi-session game-dev workflow with milestones, ADRs, and `docs/STATE.md` for projects that need to evolve over time.

Wersje

W bazie nie ma innych skilli o nazwie use-template.

Migawka bazy z 13.11.2026 · wersja paczki 7f53c067eda7 (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

  • 100improve-game
    Analizuje grę, znajduje to, co wymaga pracy, i wdraża najbardziej wpływowe poprawki, a przy każdym przebiegu kolejną najważniejszą rzecz.
  • 100game-dev
    Prowadzi budowę gry przeglądarkowej 2D od zera: ścisły wywiad odkrywczy, a potem budowa i test kolejnych systemów z testowaniem w przeglądarce po każdym z nich.
  • 95viral-game
    Zamienia wpis, wiadomość lub krótki pomysł w grę przeglądarkową w około 10 minut: szkielet, projekt graficzny, wdrożenie i monetyzację.
  • 81game-studio
    Konfiguruje Codex Game Studio dla nowej lub istniejącej gry i kieruje do właściwych przepływów pracy twórcy gier.
  • 95infrastructure-claude-code-game-workflow
    Wskazuje, który skill przeczytać przy projekcie gry, i prowadzi przez ekosystem skilli do tworzenia gier.
  • 100wf-template
    Tworzy albo edytuje interaktywnie szablon przepływu pracy weft.

Uwagi i zgłoszenia

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