Communitygithub.com

solitasroh/rkit

Static web development skill for beginners and non-developers. Covers HTML/CSS/JavaScript and Next.js App Router basics.

What is rkit?

The rkit skill is designed to help beginners and non-developers quickly start static web development projects. It provides two main technology stacks: a pure HTML/CSS/JavaScript option for complete beginners, and a Next.js (with Tailwind CSS) option for those ready to use a framework. The skill simplifies project initialization through the `init starter` or `starter init` commands, automatically generating the necessary project structure, configuration files, and beginner-friendly documentation. It also includes development guides, concept explanations with code examples (HTML, CSS, React/Next.js, Tailwind), and deployment guides for GitHub Pages or Vercel. The skill avoids covering backend features like login, databases, or payment processing, making it ideal for simple portfolio sites, landing pages, or personal websites. It supports multiple languages in its triggers and includes a learning output style (`rkit-learning`) to enhance the educational experience with explanations and hands-on tasks. Agent memory persists across sessions to track learning progress.

Works with✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/solitasroh/rkit/tree/HEAD/skills/starter

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

0. Document Structure (Three Layers of This Skill)

  1. Domain Body (§1 ~ §N): Protocol of this skill. Zero uses of locked vocabulary are automatically verified via verify-policy --check body-neutrality.
  2. Methodology Body — Domain-Neutral: The area wrapped by <!-- BEGIN: cycle3-body-neutral --> ~ <!-- END: cycle3-body-neutral --> markers in Cycle 3.
  3. Domain Example Appendix (§A): Cases by MCU/MPU/WPF domain. Auto-generated from SoT (policies/locked-vocab.json) via scripts/gen-locked-vocab.mjs.

Do not edit the appendix directly — regenerate with node scripts/gen-locked-vocab.mjs.


Beginner (Starter) Skill

Actions

ActionDescriptionExample
initProject initialization (/init-starter feature)/starter init my-portfolio
guideDisplay development guide/starter guide
helpBeginner help/starter help

init (Project Initialization)

  1. Create project directory structure (HTML/CSS/JS or Next.js)
  2. Generate package.json (when Next.js selected)
  3. Create CLAUDE.md (Level: Starter specified)
  4. Create docs/ folder structure (for PDCA documents)
  5. Initialize .rkit/state/memory.json

guide (Development Guide)

  • Analyze current project state
  • Suggest next steps appropriate for Starter level
  • Phase 1-3 focused Pipeline guide

help (Beginner Help)

  • Explain HTML/CSS/JS basic concepts
  • Answer frequently asked questions
  • Provide example code

Target Audience

  • Those learning programming for the first time
  • Those who want to create a simple website
  • Those who need a portfolio site

Tech Stack

Option A: Pure HTML/CSS/JS (For Complete Beginners)

HTML5        → Web page structure
CSS3         → Styling
JavaScript   → Dynamic features (optional)

Option B: Next.js (Using Framework)

Next.js 14+  → React-based framework
Tailwind CSS → Utility CSS
TypeScript   → Type safety (optional)

Language Tier Guidance (v1.3.0)

Recommended: Tier 1 languages only (Python, TypeScript, JavaScript)

Starter level focuses on AI-Native development with maximum AI tool support.

TierAllowedReason
Tier 1✅ YesFull AI support, Vibe Coding optimized
Tier 2⚠️ LimitedConsider Dynamic level instead
Tier 3-4❌ NoUpgrade to Dynamic/Enterprise

Project Structure

Option A: HTML/CSS/JS

project/
├── index.html          # Main page
├── about.html          # About page
├── css/
│   └── style.css       # Styles
├── js/
│   └── main.js         # JavaScript
├── images/             # Image files
├── docs/               # PDCA documents
│   ├── 01-plan/
│   └── 02-design/
└── README.md

Option B: Next.js

project/
├── src/
│   ├── app/
│   │   ├── layout.tsx      # Common layout
│   │   ├── page.tsx        # Main page
│   │   └── about/
│   │       └── page.tsx    # About page
│   └── components/         # Reusable components
├── public/                 # Static files
├── docs/                   # PDCA documents
├── package.json
├── tailwind.config.js
└── README.md

Core Concept Explanations

HTML (Web Page Structure)

<!-- Basic structure -->
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>My Website</title>
    <link rel="stylesheet" href="css/style.css">
</head>
<body>
    <header>Header</header>
    <main>Main content</main>
    <footer>Footer</footer>
</body>
</html>

CSS (Styling Web Pages)

/* Basic styles */
body {
    font-family: 'Inter', sans-serif;
    margin: 0;
    padding: 0;
}

/* Center alignment */
.container {
    max-width: 1200px;
    margin: 0 auto;
    padding: 20px;
}

/* Responsive (mobile support) */
@media (max-width: 768px) {
    .container {
        padding: 10px;
    }
}

Next.js App Router (Creating Pages)

// app/page.tsx - Main page
export default function Home() {
  return (
    <main className="container mx-auto p-4">
      <h1 className="text-3xl font-bold">
        Welcome!
      </h1>
    </main>
  );
}

// app/about/page.tsx - About page
// URL: /about
export default function About() {
  return (
    <div className="container mx-auto p-4">
      <h1>About</h1>
      <p>I am ...</p>
    </div>
  );
}

Tailwind CSS (Quick Styling)

// Frequently used classes
<div className="
  container    // Center alignment
  mx-auto      // Auto left/right margin
  p-4          // Padding 16px
  text-center  // Center text
  text-xl      // Large text
  font-bold    // Bold text
  bg-blue-500  // Blue background
  text-white   // White text
  rounded-lg   // Rounded corners
  hover:bg-blue-600  // Color change on hover
">

Deployment Methods

GitHub Pages (Free)

1. Create GitHub repository
2. Push code
3. Settings → Pages → Source: main branch
4. Access at https://username.github.io/repo-name

Vercel (Recommended for Next.js)

1. Sign up at vercel.com (GitHub integration)
2. "New Project" → Select repository
3. Click "Deploy"
4. URL automatically generated

Limitations

❌ Login/Registration (requires server)
❌ Data storage (requires database)
❌ Admin pages (requires backend)
❌ Payment features (requires backend)

When to Upgrade

Move to Dynamic Level if you need:

→ "I need login functionality"
→ "I want to store data"
→ "I need an admin page"
→ "I want users to communicate with each other"

rkit Features for Starter Level (v1.5.1)

Output Style: rkit-learning (Recommended)

For the best learning experience, activate the learning output style:

/output-style rkit-learning

This provides:

  • Learning points after each task explaining what you did and why
  • TODO(learner) markers encouraging hands-on practice
  • Concept explanations adjusted for beginner difficulty

Agent Memory (Auto-Active)

rkit agents automatically remember your learning progress across sessions. No setup needed — your starter-guide agent uses user scope memory, so learning context persists even across different projects.

Agent Teams

Agent Teams is not available for Starter level projects. When you upgrade to Dynamic level, you unlock 2-teammate parallel PDCA mode.


Common Mistakes

MistakeSolution
Image not showingCheck path (./images/photo.jpg)
CSS not appliedCheck link tag path
Page navigation not workingCheck href path (./about.html)
Broken on mobileCheck <meta name="viewport"> tag

Related Skills