.github/skills/overview/SKILL.md
Creates or updates docs/overview.md — the project's purpose and background. Load when starting a new project, when the project's goals or context have changed, or when docs/overview.md does not exist. Covers what to write, what to omit, and how to keep the document agent-friendly.
npx skillsauth add poko8nada/pj_docs overviewInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
This document captures the irreducible knowledge that cannot be derived from code, tests, or ADRs — the Why and Why Not behind the project's existence. Agents use it to understand intent when making architectural decisions.
This document should be written in Japanese.
---
last-validated: YYYY-MM-DD
phase: current
---
# [Project Name]
## Problem
[1-3 sentences: what problem, for whom]
## Goals
- [Specific, measurable goal]
- [Specific, measurable goal]
## Non-goals
- [What is out of scope and why]
## Constraints
- [External constraint: legal, SLA, org policy, etc.]
## Tech Stack Rationale
- [Choice]: [Why this over alternatives] → see ADR-NNNN
Update last-validated whenever you verify the document still reflects reality.
If any section no longer holds, update it or supersede with a new version.
A stale last-validated is a signal the document may have rotted.
tools
Composite Skill. This skill is used for project planning. Users request that a project plan be created, particularly during the initial stages.
documentation
Core Skill. This skill is for document creation. User ask you to create planning documents, such as requirement and task breakdown.
development
Core Skill. Next.js 15+ App Router architecture guidelines including component patterns, state management with Zustand, server actions, and project structure. Use when developing Next.js applications.
development
Core Skill. HonoX architecture guidelines including file-based routing, Islands pattern, component types, performance optimization, and best practices for full-stack development.