Agent skill

project-scaffolder

Creates plan.md, task.md, persona.md, project-context.md, and CLAUDE.md for new self-learning resource projects. Use when: (1) /init command is invoked, (2) setting up a new tutorial/guide/documentation project, (3) structure-designer agent needs templates for learning resource structure design. Provides hierarchical Part/Chapter/Section templates with page allocation.

Stars 232
Forks 15

Install this agent skill to your Project

npx add-skill https://github.com/aiskillstore/marketplace/tree/main/skills/bityoungjae/project-scaffolder

SKILL.md

Project Scaffolder Skill

This skill provides templates and guidance for scaffolding new self-learning resource projects.

Templates

The following templates are available in this skill directory:

Template Purpose
plan-template.md Project structure with Part/Chapter/Section hierarchy
task-template.md Session-based task checklist mirroring plan.md
persona-template.md Writer/Reader persona and code policy definitions
project-context-template.md Target environment and reference URLs
claude-md-template.md CLAUDE.md project instructions

Workflow

1. Information Gathering

Before scaffolding, collect the following information:

  • Topic: Subject of the learning resource
  • Total Pages: Estimated page count (50/100/200+)
  • Language: Primary language (ko/en)
  • Target Audience: Experience level (beginner/intermediate/advanced)
  • Target Environment: OS, tools, versions

2. File Generation Order

  1. plan.md - Main structure document (use plan-template.md)
  2. task.md - Session-divided checklist (use task-template.md)
  3. persona.md - Writer/Reader definitions (use persona-template.md)
  4. project-context.md - Environment and references (use project-context-template.md)
  5. CLAUDE.md - Project instructions for Claude (use claude-md-template.md)

3. Structure Guidelines

Hierarchy

  • Part: Major theme (50-100 pages), contains 3-6 chapters
  • Chapter: Topic group (15-30 pages), contains 3-5 sections
  • Section: Single concept (5-12 pages)

Page Allocation Formula

Content Type Percentage
Introduction/Overview 5-8%
Core Content 60-70%
Practice/Examples 20-25%
Summary/Review 5-8%

4. Session Division Rules

When creating task.md, divide work into Claude Code sessions:

  • 1 session = 3-5 sections or 20-40 pages
  • Group sections within the same Chapter/Part
  • Consider dependencies (prerequisite → subsequent)
  • Mark session boundaries with HTML comments:
markdown
<!-- Session 1: Part 1 Foundations -->
- [ ] 1.1 Introduction (8p)
- [ ] 1.2 Core Concepts (7p)

<!-- Session 2: Part 1 Architecture -->
- [ ] 1.3 System Design (10p)

5. Placeholder Variables

Use {VARIABLE_NAME} format for all placeholders:

Variable Description
{PROJECT_TITLE} Project name
{TARGET_SYSTEM} Target OS/environment
{TARGET_AUDIENCE} Reader experience level
{TOTAL_PAGES} Total estimated pages
{DATE} Creation/update date
{PART_TITLE} Part title
{CHAPTER_TITLE} Chapter title
{SECTION_TITLE} Section title
{PAGES} Page count for section

Quality Checklist

Before completing scaffolding, verify:

  • All placeholder variables use {VARIABLE_NAME} format
  • plan.md has proper Part/Chapter/Section hierarchy
  • task.md mirrors plan.md structure exactly
  • Session boundaries are marked with HTML comments
  • Page allocations sum to total target pages
  • All template files are properly referenced

Expand your agent's capabilities with these related and highly-rated skills.

aiskillstore/marketplace

perigon-backend

Perigon ASP.NET Core + EF Core + Aspire conventions

232 15
Explore
aiskillstore/marketplace

perigon-agent

Pointers for Copilot/agents to apply Perigon conventions

232 15
Explore
aiskillstore/marketplace

perigon-angular

Angular 21+ standalone/Material/signal conventions for Perigon WebApp

232 15
Explore
aiskillstore/marketplace

fastapi-mastery

Comprehensive FastAPI development skill covering REST API creation, routing, request/response handling, validation, authentication, database integration, middleware, and deployment. Use when working with FastAPI projects, building APIs, implementing CRUD operations, setting up authentication/authorization, integrating databases (SQL/NoSQL), adding middleware, handling WebSockets, or deploying FastAPI applications. Triggered by requests involving .py files with FastAPI code, API endpoint creation, Pydantic models, or FastAPI-specific features.

232 15
Explore
aiskillstore/marketplace

context7-efficient

Token-efficient library documentation fetcher using Context7 MCP with 86.8% token savings through intelligent shell pipeline filtering. Fetches code examples, API references, and best practices for JavaScript, Python, Go, Rust, and other libraries. Use when users ask about library documentation, need code examples, want API usage patterns, are learning a new framework, need syntax reference, or troubleshooting with library-specific information. Triggers include questions like "Show me React hooks", "How do I use Prisma", "What's the Next.js routing syntax", or any request for library/framework documentation.

232 15
Explore
aiskillstore/marketplace

browser-use

Browser automation using Playwright MCP. Navigate websites, fill forms, click elements, take screenshots, and extract data. Use when tasks require web browsing, form submission, web scraping, UI testing, or any browser interaction.

232 15
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results