github-repo-architect

github-repo-architect is a skill for Claude Code, Codex from mickpletcher/AI-Skills. It costs 106 tokens per session (2,622 once invoked), scanned A, original, MIT.

A repository-architecture planner that turns a software idea into a complete GitHub repository structure. A repository is the project folder where code, documentation, and related files are managed.

In plain words
What is it for?
Use it to design or scaffold a GitHub repository, plan its folder structure, or turn a project idea into repository architecture.
Why use it?
It helps decide how a new project should be organised before implementation begins. This gives the project a planned home for its code and supporting files.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: mentions Codex.

Good fit Use it to design or scaffold a GitHub repository, plan its folder structure, or turn a project idea into repository architecture.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/mickpletcher/ai-skills/github-repo-architect
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add mickpletcher/AI-Skills --skill github-repo-architect
Clone the repo
git clone --depth 1 https://github.com/mickpletcher/AI-Skills

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for github-repo-architect

README.md
[![agentmods](https://agentmods.dev/badge/skills/mickpletcher/ai-skills/github-repo-architect/github.svg)](https://agentmods.dev/skills/mickpletcher/ai-skills/github-repo-architect)
Your own site
<a href="https://agentmods.dev/skills/mickpletcher/ai-skills/github-repo-architect"><img src="https://agentmods.dev/badge/skills/mickpletcher/ai-skills/github-repo-architect/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for github-repo-architect

Your own site · 80×15
<a href="https://agentmods.dev/skills/mickpletcher/ai-skills/github-repo-architect"><img src="https://agentmods.dev/badge/skills/mickpletcher/ai-skills/github-repo-architect.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 106 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,622 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00106 $0.02622
Opus 5.5 $0.00042 $0.01049
Sonnet 5.5 $0.00021 $0.00524
Haiku 4.5 $0.00011 $0.00262

Measured 2mo ago against content hash d4d5eaa888b4, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

github-repo-architect scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

claude/skills/github-repo-architect/SKILL.md · 283 lines

How it starts

The opening of the file, as written. The whole thing — 283 lines — stays where its author put it; the contents beside it link to each section on GitHub.

GitHub Repo Architect Skill

Intent

Turn rough software ideas into practical GitHub repository structures with files, workflows, prompts, and setup direction.

Workflow

  1. Identify the exact task and available source material.
  2. Apply the domain rules and output format in this skill.
  3. State assumptions, uncertainty, and missing inputs clearly.
  4. Return the requested artifact, recommendation, or review in a practical format.
  5. Check the result against the validation checklist before finishing.

Constraints

  • Do not fabricate missing facts, measurements, dates, sources, or user context.
  • Keep output aligned with Mick's direct, practical communication style unless the skill says otherwise.
  • Preserve safety, legal, medical, financial, and operational boundaries stated in this file.
  • Prefer concise, usable output over broad explanation.

Turn a rough project idea into a complete GitHub repository plan that can be implemented directly. Produce the repository structure, README, prompts, CI pipeline, and starter files that fit the project.

Primary Triggers

repo, gra, or architect repo — Provide the idea after the trigger and generate the repository architecture immediately.

Other triggers: "build a repo structure", "design a GitHub repo", "scaffold this repository", "create repository architecture", "turn this idea into a repo"

repo [project idea, target language, or rough requirements]
gra [GitHub repo concept]
architect repo [existing notes or spec]

Do Not Use When

  • The user wants to improve an existing repo that already has structure — use a code review or audit approach instead.
  • The user only needs a README written for a known repo layout — use the github-readme skill instead.
  • The user has no project idea and wants a generic starter template with no specifics — ask for a concrete idea before proceeding.
  • The request is for a private or sensitive system (internal corporate infra, credential vaults, personal data stores) and no security context has been provided — gather security requirements first.

Read the full file on GitHub · 283 lines

Files

What ships with it

4 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2mo ago First seen · 283 lines · 106 tokens per session scan A d4d5eaa888b4

Subscribe to this mod's changes

github-repo-architect is a skill published in the GitHub repository mickpletcher/AI-Skills (20 stars, last pushed 4d ago), licensed MIT. It adds 106 tokens to every session and 2,622 once invoked, about $0.0004 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

changelog-generator

Convierte un git log, lista de commits o notas de lanzamiento en un changelog pulido orientado al usuario. Usa cuando estés escribiendo notas de versión, generando una entrada en CHANGELOG.md o documentando qué cambió en una versión. Produce una sección de changelog estructurada con encabezado de versión, cambios…

mohitagw15856/pm-claude-skills · 96 tokens

pr-description-writer

Redacta una descripción de pull request clara y estructurada a partir de un diff de git, resumen de rama o lista de commits. Úsalo cuando te pidan escribir una descripción de PR, redactar una solicitud de cambios o documentar cambios de código. Produce una descripción con resumen, motivación, cambios realizados, pasos…

mohitagw15856/pm-claude-skills · 80 tokens

release-notes-from-git-log

Turn a git log into user-facing release notes grouped by feature and fix. Use when asked for release notes from this git log, a changelog entry from these commits, or to turn commits into release notes. Produces a grouped changelog with one line per change and a short headline.

mohitagw15856/pm-claude-skills · 66 tokens

releasing-godot-prompter

Use when cutting a GodotPrompter release or bumping its version — the version-bump sequence, tag-triggered workflow, and the marketplace manifests that must follow.

jame581/GodotPrompter · 44 tokens

epic-dev

Execute the project epic development workflow for Codex. Use when the user asks for "epic dev", "epic-dev", "/epic-dev", "run the epic workflow", "create an epic", "resume the epic", "--resume", "--next-phase", "--finalize", phased feature delivery, sprint phases, GitHub sub-issues, or git worktrees for multi-phase…

neuromechanist/research-skills · 84 tokens

workflow-reference

This skill should be used when executing the epic-dev workflow, creating epic branches, managing sprint phases, working with git worktrees for phased feature development, or when the user mentions "epic dev", "epic-dev", "/epic-dev", "epic workflow", "sprint phases", "phased development", or "git worktree workflow".

neuromechanist/research-skills · 75 tokens