One-click install
npx skills add https://github.com/EliasOulkadi/shokunin --skill init-eliasoulkadi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: init
Source: https://github.com/EliasOulkadi/shokunin/tree/main/.pack/skills/init
Command: npx skills add https://github.com/EliasOulkadi/shokunin --skill init-eliasoulkadi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams quickly produce clear, accurate contributor documentation by analyzing an existing codebase and translating what it finds into an AGENTS.md contributor guide.

Core Features & Use Cases

  • AGENTS.md generator: Creates a concise, accurate repository-wide contributor guide based on the actual structure and evidence found in the codebase.
  • Command and convention extraction: Pulls real build/dev/test commands from the repository’s build system (e.g., package scripts, make targets) and captures enforceable coding conventions from linter/formatter and agent rule files when present.
  • Improvement-ready behavior: When AGENTS.md already exists, it generates a fix-focused diff and asks for confirmation before overwriting, avoiding loss of correct, specific knowledge.

Quick Start

Ask your AI to run the init skill to analyze the current repository directory and generate or update AGENTS.md with the Project Guidelines.

Frequently Asked Questions about init

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an AGENTS.md file for my repository contributors?

To generate an AGENTS.md file, this Skill analyzes your existing codebase structure, build commands, and coding conventions to produce a 200-400 word contributor guide. It probes repository files and recent git history to ensure all documentation is evidence-based and accurate.

What is evidence-based repository documentation and how does it work?

Evidence-based repository documentation means contributor guidelines are generated strictly from verified source files rather than fabricated details. This Skill probes build systems, linter configurations, and git history to extract real commands and coding conventions for the AGENTS.md file.

How do I extract build commands and coding conventions for contributor guidelines?

Build commands and coding conventions are extracted by probing the repository's build system scripts, linter configurations, and formatter rules. The Skill captures enforceable conventions directly from these source files and translates them into the AGENTS.md contributor documentation.

Can I update an existing AGENTS.md file without losing correct project guidelines?

Yes, when an AGENTS.md file already exists, the Skill generates a fix-focused diff and asks for confirmation before overwriting. This behavior prevents the loss of specific, correct knowledge already present in your repository documentation.

Does the init skill work without dependencies or external components?

Yes, the Skill operates with zero dependencies and no external components. It initializes agent-oriented project docs by directly analyzing the current repository directory structure and recent git history when available.

What is the word count limit for generated AGENTS.md contributor docs?

The generated AGENTS.md contributor documentation is strictly enforced to be between 200 and 400 words. This concise output requirement ensures the repository guidelines remain focused and easily readable for onboarding contributors.