skills.rest
mickpletcher
mickpletcherCOMMUNITY
Explore all skills by this author →
Website𝕏@mick_pletcherGitHub

github-repo-architect

Convert rough software ideas into GitHub repository structures with files and CI workflows.

14|2|Updated Apr 24, 2026
Search Tags:#github#project planning#scaffolding#github actions#readme generation#issue templates#repository architecture
One-click install
npx skills add https://github.com/mickpletcher/AI-Skills --skill github-repo-architect
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: github-repo-architect
Source: https://github.com/mickpletcher/AI-Skills/tree/main/claude/skills/github-repo-architect
Command: npx skills add https://github.com/mickpletcher/AI-Skills --skill github-repo-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converting a rough project idea into a complete, implementable GitHub repository structure (files, docs, CI, and templates) without missing important setup steps.

Core Features & Use Cases

  • Repo blueprint generation: Produces an annotated folder layout and a generated file list tailored to the detected project type.
  • Implementation-ready README: Writes a complete README with practical sections like setup, usage, testing, configuration, and security notes.
  • Operational scaffolding: Generates GitHub Actions CI plus issue and pull request templates to help teams start cleanly.
  • Use case: You have an idea like a FastAPI service or a CLI tool and want a repo you can start building immediately with clear structure and next steps.

Quick Start

Tell the skill: "architect repo a Python FastAPI service with JWT auth and PostgreSQL" and paste your requirements as needed.

Frequently Asked Questions about github-repo-architect

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

FAQPage Schema
How do I generate a complete GitHub repository architecture from a rough project idea?▼

To generate a GitHub repository architecture, provide a rough software idea like a FastAPI service or CLI tool. The skill converts it into a practical folder layout, file list, README, GitHub Actions CI workflow, and issue templates.

Does this scaffolding tool generate GitHub Actions CI workflows and issue templates automatically?▼

Yes, this scaffolding tool generates GitHub Actions CI workflows alongside issue and pull request templates automatically. It creates operational scaffolding to help teams start building cleanly with clear structure and next steps.

Can I use this to create a README and folder layout for an infrastructure or data project?▼

Yes, you can create a README and folder layout for infrastructure or data projects. The skill applies to new projects including CLI tools, API services, web apps, automation repos, and data projects with tailored implementation direction.

What is the best way to structure a new GitHub repository without missing important setup steps?▼

The best way to structure a new GitHub repository is converting your rough idea into a full blueprint with an annotated folder layout, implementation-ready README, and operational scaffolding. This prevents missing important setup steps during initial project configuration.

Will the generated repository blueprint fabricate missing project details or requirements?▼

No, the generated repository blueprint will not fabricate missing project details. It follows strict output guardrails that avoid fabricating missing details, ensuring the architecture remains practical and implementable based solely on provided requirements.

How do I architect a Python FastAPI service repository with JWT auth and PostgreSQL?▼

To architect a Python FastAPI service repository, tell the skill your requirements like JWT auth and PostgreSQL. It produces a tailored README, CI workflow, and templates, converting the idea into an implementable folder structure.

Related Skills

Explore More Software Engineering Skills→
timequitytimequity
6

brainstorming

Convert rough ideas into detailed designs through Socratic dialogue.

Official
Basic
mashharukimashharuki

repo-documentation

Generate README-style documentation from repository files and directory structure.

Community
Intermediate
jeremylongshorejeremylongshore
2.6k

building-cicd-pipelines

Generate CI/CD pipeline configurations for GitHub Actions, GitLab CI, and Jenkins.

Community
Intermediate
vinhgiangvinhgiang

nx-generate

Generate code artifacts in an Nx monorepo using Nx generators.

Community
Intermediate