Agent skill

Instruction Generation

by bitovi in bitovi/ai-enablement-prompts

Onboard an AI agent to an unknown codebase by generating a comprehensive instructions file.

MITAuto-check passedWriting & Content

Install Instruction Generation

skills CLI
$ npx skills add bitovi/ai-enablement-prompts --skill instruction-generation -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install bitovi/ai-enablement-prompts instruction-generation --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/bitovi/ai-enablement-prompts.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/code/skills/instruction-generation .claude/skills/instruction-generation && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
instruction-generation
GitHub stars
121
Token cost
~1.4k tokens
SKILL.md length
522 words
Files
7
Skills in repo
40
Repo updated
First seen
Licence
MIT

At a glance

Onboard an AI agent to an unknown codebase by generating a comprehensive instructions file.

  • Works in 5 steps: Determine Tech Stack → Categorize Files → Identify Architecture ⇄ Step 5: Style… → …
  • Asked to analyze a codebase
  • SKILL.md covers Overview, Parameters, Execution and Alternative: All-in-One Usage
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Instruction Generation is an agent skill from bitovi/ai-enablement-prompts. Onboard an AI agent to an unknown codebase by generating a comprehensive instructions file. Use when asked to analyze a codebase, generate copilot instructions, create an onboarding document, or teach an AI about a project. Runs a 6-step prompt chain covering tech stack, file categorization, architecture, domain analysis, style guides, and instruction building.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files (for example `1-determine-techstack.md`, `2-categorize-files.md` and `3-identify-architecture.md`).

It sits in Writing & Content, covering Agent instruction files. The repository describes itself as: Prompts Bitovi uses for software development. The licence is MIT.

When your agent uses it

  • Asked to analyze a codebase
  • Generate copilot instructions
  • Create an onboarding document
  • Teach an AI about a project

Example prompts

  • “/instruction-generation”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Determine Tech Stack
  2. Categorize Files
  3. Identify Architecture ⇄ Step 5: Style Guide Generation (parallel)
  4. Domain Deep Dive
  5. Build Instructions

What it can do on your machine

Read from SKILL.md and the folder at commit df229b1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Instruction Generation loads about 1.4k tokens when it runs. Until then it costs about 97 tokens; SKILL.md has 522 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~97
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from bitovi/ai-enablement-prompts at commit df229b1, republished under its MIT licence (© bitovi). 522 words, ~1,371 tokens.

Download SKILL.mdSave it as .claude/skills/instruction-generation/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
instruction-generation
description
Onboard an AI agent to an unknown codebase by generating a comprehensive instructions file. Use when asked to analyze a codebase, generate copilot instructions, create an onboarding document, or teach an AI about a project. Runs a 6-step prompt chain covering tech stack, file categorization, architecture, domain analysis, style guides, and instruction building.

Skill: Instruction Generation

This skill guides you through a multi-step analysis chain to generate a comprehensive instructions file (e.g., copilot-instructions.md) by analyzing the structure, patterns, and intent of a codebase. The resulting file helps AI tools operate more effectively within the project by providing clear architectural context, domain understanding, and stylistic guidelines.

Overview

This prompt chain walks through structured steps to extract meaningful insights from a codebase:

  • Identifying the technology stack and major frameworks
  • Mapping out file purposes and categorizing project structure
  • Inferring architecture and design patterns
  • Understanding domain concepts and key features
  • Generating stylistic and structural guidance for future code contributions

The final output serves as a high-level onboarding and guidance document that aligns AI-generated code with the project's existing conventions and design.

Parameters

Before starting, define these parameters:

  • {output-folder} — Path where intermediate analysis files are saved (e.g., .results/)
  • {final_output_file} — Final combined output file (e.g., /.github/copilot-instructions.md)
Tooloutput-folderfinal_output_file
Copilot.results//.github/copilot-instructions.md
Windsurf.windsurf//.windsurf/instructions.md
Claude.results/CLAUDE.md

Execution

Run the following steps in order. Each step reads the output of previous steps.

For each step:

  1. Read the corresponding sub-prompt file from this skill's folder
  2. Launch a subagent with the sub-prompt contents, substituting {output-folder} and {final_output_file} with the resolved parameter values
  3. Wait for the subagent to complete before moving to the next step (unless steps can run in parallel — see below)

The sub-prompt files are located alongside this SKILL.md file.

Execution Order

Steps 3 and 5 have no dependency on each other and should be run in parallel to save time:

Step 1 (Tech Stack)
  ↓
Step 2 (Categorize Files)
  ↓
Step 3 (Architecture)  ←──── run in parallel ────→  Step 5 (Style Guides)
  ↓
Step 4 (Domain Deep Dive)
  ↓
Step 6 (Build Instructions)

Step 1: Determine Tech Stack

Read ./1-determine-techstack.md and launch a subagent with its contents.

The subagent should analyze the codebase and write its findings to ./{output-folder}/1-techstack.md.


Step 2: Categorize Files

Depends on: Step 1

Read ./2-categorize-files.md and launch a subagent with its contents.

The subagent should read ./{output-folder}/1-techstack.md first, then categorize every file in the codebase and write the result to ./{output-folder}/2-file-categorization.json.


Show full SKILL.md (203 more words)Show less
Step 3: Identify Architecture ⇄ Step 5: Style Guide Generation (parallel)

After Step 2 completes, launch Steps 3 and 5 as parallel subagents — they have no dependency on each other.

Step 3: Identify Architecture

Depends on: Steps 1, 2

Read ./3-identify-architecture.md and launch a subagent with its contents.

The subagent should read ./{output-folder}/1-techstack.md and ./{output-folder}/2-file-categorization.json, then identify architectural domains and write the result to ./{output-folder}/3-architectural-domains.json.

Step 5: Style Guide Generation

Depends on: Step 2

Read ./5-styleguide-generation.md and launch a subagent with its contents.

The subagent should read ./{output-folder}/2-file-categorization.json, then for each category write a style guide to ./{output-folder}/5-style-guides/{category}.md.


Step 4: Domain Deep Dive

Depends on: Step 3

Wait for Step 3 to complete. Read ./4-domain-deep-dive.md and launch a subagent with its contents.

The subagent should read ./{output-folder}/3-architectural-domains.json and ./{output-folder}/1-techstack.md, then for each domain write findings to ./{output-folder}/4-domains/{domain}.md.


Step 6: Build Instructions

Depends on: Steps 3, 4, 5 (all must be complete)

Read ./6-build-instructions.md and launch a subagent with its contents.

The subagent should synthesize all previous outputs (including ./{output-folder}/4-domains/{domain}.md files) and generate the final instruction file at {final_output_file}.


Alternative: All-in-One Usage

You can run this entire chain by providing the agent with these parameters and instructing it to execute all 6 steps in sequence:

{output-folder} = .results
{final_output_file} = /.github/copilot-instructions.md

Execute the instruction-generation skill steps 1 through 6 in order.
For each step, read the sub-prompt file and launch a subagent to perform the work.
Stop only when all steps are complete and {final_output_file} is generated.

© bitovi, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files in plugins/code/skills/instruction-generation of bitovi/ai-enablement-prompts.

  • SKILL.md
  • 1-determine-techstack.md
  • 2-categorize-files.md
  • 3-identify-architecture.md
  • 4-domain-deep-dive.md
  • 5-styleguide-generation.md
  • 6-build-instructions.md

Open the folder on GitHubat commit df229b1

Compare with similar skills

Instruction Generation next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Instruction Generation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Instruction Generation this skillbitovi/ai-enablement-prompts121—~1.4kAutomated safety check: PassMIT
Unslop FileMohamedAbdallah-14/unslop1541 repos~2.7kAutomated safety check: WarnMIT
Translate DocsMoonshotAI/kimi-code7.8k—~976Automated safety check: PassMIT
Write Evlog Contentevloghq/evlog1.9k—~386Automated safety check: PassMIT
Asd Ste100danyuchn/asd-ste100-skill4k—~4.1kAutomated safety check: PassMIT
Audit Session Metricscentminmod/my-claude-code-setup2.7k—~2.1kAutomated safety check: PassMIT

Similar skills

  • Unslop File

    MohamedAbdallah-14/unslop

    Humanize natural-language memory files (CLAUDE.md, todos, preferences, docs) by removing AI-isms and adding burstiness while preserving every code block, URL, path, command, and heading exactly.

    154 GitHub starsUsed in 1 repo~2.7k tokens
    Writing & ContentAuto-check: warnings
  • Translate Docs

    MoonshotAI/kimi-code

    Translate and sync bilingual user documentation between docs/zh/ and docs/en/ following the source-of-truth rules in docs/AGENTS.md.

    7.8k GitHub stars~976 tokensUpdated today
    Writing & ContentAuto-check passed
  • Write Evlog Content

    evloghq/evlog

    The evlog content doctrine, for anyone drafting or judging evlog prose: a docs page, the landing, a blog post, a package README, a skill, an AGENTS.md, a changeset.

    1.9k GitHub stars~386 tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Asd Ste100

    danyuchn/asd-ste100-skill

    A skill your agent uses when English text must be parsed without a human to resolve ambiguity — tool descriptions, error messages, inter-agent instructions, system prompts, status reports — and…

    4k GitHub stars~4.1k tokensUpdated 4 days ago
    Writing & ContentAuto-check passed
  • Audit Session Metrics

    centminmod/my-claude-code-setup

    Audit a session-metrics JSON export for token-usage waste and produce a plain-English findings report.

    2.7k GitHub stars~2.1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Ponylang Prose Review

    ponylang/ponylang-website

    Ensemble review of ponylang blog and Last Week in Pony prose.

    160 GitHub stars~2.9k tokensUpdated 4 days ago
    Agent WorkflowsAuto-check passed

More from bitovi/ai-enablement-prompts

All 40 skills in this repo
  • Component Registry

    bitovi/ai-enablement-prompts

    Track reusable UI components and unextracted patterns. An agent skill from bitovi/ai-enablement-prompts.

    121 GitHub stars~597 tokensUpdated 27 days ago
    Auto-check passed
  • Computed Styles

    bitovi/ai-enablement-prompts

    Extract and compare computed CSS styles between a baseline URL and a dev/Storybook URL using Playwright MCP evaluate calls.

    121 GitHub stars~2.4k tokensUpdated 27 days ago
    Auto-check passed
  • Create Plugin

    bitovi/ai-enablement-prompts

    A skill your agent uses when the user asks to "create a plugin", "add a plugin", "make a new plugin", "build a plugin", or wants to package skills into an installable plugin for this marketplace.

    121 GitHub stars~2k tokensUpdated 27 days ago
    Auto-check passed
  • Create React Modlet

    bitovi/ai-enablement-prompts

    Create React components, hooks, or utilities following the modlet pattern.

    121 GitHub stars~2.1k tokensUpdated 27 days ago
    Auto-check passed
  • Create Skill

    bitovi/ai-enablement-prompts

    A skill your agent uses when the user asks to "create a skill", "add a skill", "make a new skill", "build a skill", or wants to automate a repeated workflow into a reusable prompt.

    121 GitHub stars~1.6k tokensUpdated 27 days ago
    Auto-check passed
  • Create Skill

    bitovi/ai-enablement-prompts

    Create new Agent Skills for this project. An agent skill from bitovi/ai-enablement-prompts.

    121 GitHub stars~1.7k tokensUpdated 27 days ago
    Auto-check passed

Questions about Instruction Generation

What does Instruction Generation do?

Onboard an AI agent to an unknown codebase by generating a comprehensive instructions file. Instruction Generation is an agent skill from bitovi/ai-enablement-prompts. Onboard an AI agent to an unknown codebase by generating a comprehensive instructions file.

When should I use Instruction Generation?

Instruction Generation fits situations like: asked to analyze a codebase; generate copilot instructions; create an onboarding document; teach an AI about a project.

How do I install Instruction Generation in Claude Code?

Run `npx skills add bitovi/ai-enablement-prompts --skill instruction-generation -a claude-code`. Or copy the skill folder (plugins/code/skills/instruction-generation in bitovi/ai-enablement-prompts) into .claude/skills/instruction-generation in your project. Claude Code loads it when a task matches its description.

How do I install Instruction Generation in Codex?

Run `npx skills add bitovi/ai-enablement-prompts --skill instruction-generation -a codex`. Or copy the skill folder (plugins/code/skills/instruction-generation in bitovi/ai-enablement-prompts) into .agents/skills/instruction-generation in your project. Codex loads it when a task matches its description.

Can I use Instruction Generation in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add bitovi/ai-enablement-prompts --skill instruction-generation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/instruction-generation, .gemini/skills/instruction-generation, .github/skills/instruction-generation and .opencode/skills/instruction-generation in your project.

What does Instruction Generation need to run?

SKILL.md names no scripts, command-line tools or credentials: Instruction Generation is instructions for the agent only.

Does Instruction Generation access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Instruction Generation safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Instruction Generation use?

Instruction Generation is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Instruction Generation use?

About 1.4k tokens (SKILL.md is roughly 5.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Instruction Generation?

Skills that share tags, products or a category with Instruction Generation: Unslop File (MohamedAbdallah-14/unslop, 154 stars), Translate Docs (MoonshotAI/kimi-code, 7.8k stars), Write Evlog Content (evloghq/evlog, 1.9k stars) and Asd Ste100 (danyuchn/asd-ste100-skill, 4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Instruction Generation?

bitovi (a GitHub organization) maintains it in bitovi/ai-enablement-prompts, which has 121 GitHub stars. The repository holds 40 skills in this directory. The repository was last updated on September 11, 2026.

Source: bitovi/ai-enablement-prompts on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.