⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

v0.1.0

gitmancer

guillermovzq@guillermovzq⭐ 1 stars· last commit 1mo ago· 0 open issues

Create, structure, document, and maintain top-tier GitHub repositories with 2026 best practices. Use when a user asks for repo naming, folder architecture, README creation, governance files, CI workflows, release checklist, or long-term maintainer guidance.

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐ 1 on GitHubGitHub ↗

New / niche

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README

Gitmancer

Language License CI

Specialized skill + repository toolkit to bootstrap and maintain professional-grade GitHub repositories (2026 standards).

Core capabilities

  • Repository naming strategy + topics
  • Production-grade repository structure
  • Ultra-modern README generation (EN/ES ready)
  • Governance and policy files (security, code of conduct, contribution)
  • GitHub Actions baseline (lint/test/build/scorecards)
  • Release + maintenance checklist

Quick start

python -m src.generator --project "Alchemical Agent Ecosystem" --type "ai-platform" --out ./out

Included assets

  • SKILL.md for AI-agent usage
  • Templates in templates/
  • Governance docs in docs/
  • CI baseline in .github/workflows/

License

MIT © 2026 smouj

// HOW IT'S BUILT

// FILES

30 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

  • workspace/skills/Gitmancer/SKILL.md1.1 KB60e8585a1feaupstream ↗
    ---
    name: gitmancer
    description: Create, structure, document, and maintain top-tier GitHub repositories with 2026 best practices. Use when a user asks for repo naming, folder architecture, README creation, governance files, CI workflows, release checklist, or long-term maintainer guidance.
    ---
    
    # Gitmancer
    
    When invoked, produce a complete repository package with:
    1. Repository naming and topic recommendations.
    2. Modern folder tree aligned to project type.
    3. Complete README.md with badges, architecture, setup, usage, roadmap.
    4. Governance files:
       - LICENSE
       - CONTRIBUTING.md
       - CODE_OF_CONDUCT.md
       - SECURITY.md
       - issue templates + PR template
    5. CI recommendations and baseline workflows.
    6. Launch + maintenance checklist.
    7. Practical “gold tips” for discoverability and maintainability.
    
    ## Output contract
    - Always return copy-paste-ready markdown/code blocks.
    - Keep claims realistic to project state.
    - Separate implemented vs planned items clearly.
    - Prefer concise, maintainable defaults over over-engineering.
    
    ## Reference files
    - `docs/PLAYBOOK.md`
    - `templates/README.template.md`
    - `templates/GOVERNANCE_CHECKLIST.md`
    
  • workspace/skills/Gitmancer/README.md1.1 KBe1734d03c261upstream ↗
    # Gitmancer
    
    <p align="center">
      <img src="./assets/branding/logo.svg" alt="Gitmancer logo" width="96" />
    </p>
    
    ![Language](https://img.shields.io/badge/language-Markdown%20%2B%20Python-blue)
    ![License](https://img.shields.io/badge/license-MIT-green)
    ![CI](https://img.shields.io/github/actions/workflow/status/smouj/Gitmancer/ci.yml?branch=main)
    
    **Specialized skill + repository toolkit to bootstrap and maintain professional-grade GitHub repositories (2026 standards).**
    
    ## Core capabilities
    - Repository naming strategy + topics
    - Production-grade repository structure
    - Ultra-modern README generation (EN/ES ready)
    - Governance and policy files (security, code of conduct, contribution)
    - GitHub Actions baseline (lint/test/build/scorecards)
    - Release + maintenance checklist
    
    ## Quick start
    ```bash
    python -m src.generator --project "Alchemical Agent Ecosystem" --type "ai-platform" --out ./out
    ```
    
    ## Included assets
    - `SKILL.md` for AI-agent usage
    - Templates in `templates/`
    - Governance docs in `docs/`
    - CI baseline in `.github/workflows/`
    
    ## License
    MIT © 2026 smouj
    
  • workspace/skills/Gitmancer/assets/branding/logo.svg583 B1c3634960c3aupstream ↗
    <svg width="256" height="256" viewBox="0 0 256 256" fill="none" xmlns="http://www.w3.org/2000/svg">
      <defs>
        <linearGradient id="g1" x1="32" y1="32" x2="224" y2="224" gradientUnits="userSpaceOnUse">
          <stop stop-color="#7C3AED"/>
          <stop offset="1" stop-color="#22D3EE"/>
        </linearGradient>
      </defs>
      <rect x="20" y="20" width="216" height="216" rx="40" fill="#0A0E17"/>
      <path d="M74 84h108v22H74V84zm0 34h108v22H74v-22zm0 34h72v22H74v-22z" fill="url(#g1)"/>
      <path d="M170 162l16 16m0-16l-16 16" stroke="#FBBF24" stroke-width="8" stroke-linecap="round"/>
    </svg>
    
  • workspace/skills/Gitmancer/.github/CODEOWNERS9 Bd6b9b1ad1affupstream ↗
    * @smouj
    
  • workspace/skills/Gitmancer/.github/ISSUE_TEMPLATE/bug_report.md121 B6a5565fb7a3aupstream ↗
    ---
    name: Bug report
    about: Report a reproducible issue
    ---
    
    ## Description
    
    ## Steps to reproduce
    
    ## Expected behavior
    
  • workspace/skills/Gitmancer/.github/ISSUE_TEMPLATE/feature_request.md122 B9a5c4a47406bupstream ↗
    ---
    name: Feature request
    about: Suggest an improvement
    ---
    
    ## Problem
    
    ## Proposed solution
    
    ## Alternatives considered
    
  • workspace/skills/Gitmancer/.github/pull_request_template.md93 B731d9a11a62aupstream ↗
    ## Summary
    
    ## Changes
    
    ## Validation
    - [ ] lint
    - [ ] test
    - [ ] build
    
    ## Risks / Rollback
    
  • workspace/skills/Gitmancer/.github/workflows/ci.yml311 B2f9f5048ed60upstream ↗
    name: CI
    on:
      push:
      pull_request:
    jobs:
      quality:
        runs-on: ubuntu-latest
        steps:
          - uses: actions/checkout@v4
          - uses: actions/setup-python@v5
            with:
              python-version: '3.11'
          - run: python -m pip install --upgrade pip
          - run: python -m py_compile src/generator.py
    
  • workspace/skills/Gitmancer/.gitignore41 Bfa106b98f6f4upstream ↗
    __pycache__/
    *.pyc
    .venv/
    out/
    .DS_Store
    
  • workspace/skills/Gitmancer/CHANGELOG.md201 B6d9ca3107970upstream ↗
    # Changelog
    
    All notable changes to this project will be documented in this file.
    
    ## 0.1.0 - 2026-02-24
    - Initial Gitmancer scaffold.
    - Added governance, CI baseline, templates, and generator script.
    
  • workspace/skills/Gitmancer/CODE_OF_CONDUCT.md98 B7908d09b1e99upstream ↗
    # Code of Conduct
    
    This project follows the Contributor Covenant. Be respectful and constructive.
    
  • workspace/skills/Gitmancer/CONTRIBUTING.md158 B1fe52a8ba725upstream ↗
    # Contributing
    
    ## Branching
    - feat/*
    - fix/*
    - chore/*
    
    ## Commit convention
    Use Conventional Commits.
    
    ## Validation
    Run lint/test/build before opening PR.
    
  • workspace/skills/Gitmancer/docs/ARCHITECTURE.md183 B05d93348455eupstream ↗
    # Architecture
    
    Gitmancer provides:
    - A reusable skill definition (`SKILL.md`)
    - Repository templates and governance checklists
    - A lightweight generator CLI (`src/gitmancer/cli.py`)
    
  • workspace/skills/Gitmancer/docs/BRANDING.md82 B99b3ece4b6d5upstream ↗
    # Branding
    
    Primary logo: `assets/branding/logo.svg`
    Theme: dark alchemy gradient
    
  • workspace/skills/Gitmancer/docs/DEPLOYMENT.md79 B4ff2b18b7689upstream ↗
    # Deployment
    
    Gitmancer is source-distributed. No runtime deployment required.
    
  • workspace/skills/Gitmancer/docs/IMPLEMENTATION.md147 Ba6deac7e5e4fupstream ↗
    # Implementation Guide
    
    1. Define project context.
    2. Generate repository baseline.
    3. Apply governance and CI templates.
    4. Validate and iterate.
    
  • workspace/skills/Gitmancer/docs/PLAYBOOK.md265 B18bc736a26bfupstream ↗
    # GitHub Alchemy Playbook
    
    ## Workflow
    1. Clarify project type and audience.
    2. Propose 3-5 repo names and topics.
    3. Produce tree structure by stack.
    4. Generate README (realistic, value-first).
    5. Add governance and CI.
    6. Validate with lint/test/build commands.
    
  • workspace/skills/Gitmancer/docs/RELEASE.md79 B0f5a586b291bupstream ↗
    # Release
    
    - Update CHANGELOG
    - Tag release
    - Publish repository documentation
    
  • workspace/skills/Gitmancer/docs/RUNBOOK.md105 B398c20f7e7cbupstream ↗
    # Runbook
    
    ## Local test
    ```bash
    python -m src.gitmancer.cli --project "Demo" --type app --out ./out
    ```
    
  • workspace/skills/Gitmancer/LICENSE1.0 KBeeded2b88af9upstream ↗
    MIT License
    
    Copyright (c) 2026 smouj
    
    Permission is hereby granted, free of charge, to any person obtaining a copy
    of this software and associated documentation files (the "Software"), to deal
    in the Software without restriction, including without limitation the rights
    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
    copies of the Software, and to permit persons to whom the Software is
    furnished to do so, subject to the following conditions:
    
    The above copyright notice and this permission notice shall be included in all
    copies or substantial portions of the Software.
    
    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
    SOFTWARE.
    
  • workspace/skills/Gitmancer/README.es.md96 B54919c2f2383upstream ↗
    # Gitmancer
    
    Skill y toolkit para crear repositorios GitHub profesionales con estándares 2026.
    
  • workspace/skills/Gitmancer/requirements.txt32 B3a09422267b2upstream ↗
    # Runtime intentionally minimal
    
  • workspace/skills/Gitmancer/SECURITY.md120 Bca1c19c1ed29upstream ↗
    # Security Policy
    
    Report vulnerabilities privately to the maintainers.
    Do not open public issues with exploit details.
    
  • workspace/skills/Gitmancer/src/generator.py74 Ba447b8f72f74upstream ↗
    from src.gitmancer.cli import main
    
    if __name__ == "__main__":
        main()
    
  • workspace/skills/Gitmancer/src/gitmancer/__init__.py19 B470d69364541upstream ↗
    __all__ = ["main"]
    
  • workspace/skills/Gitmancer/src/gitmancer/cli.py563 B19911175fdecupstream ↗
    from pathlib import Path
    import argparse
    
    
    def main():
        ap = argparse.ArgumentParser()
        ap.add_argument("--project", required=True)
        ap.add_argument("--type", default="app")
        ap.add_argument("--out", default="./out")
        args = ap.parse_args()
    
        out = Path(args.out)
        out.mkdir(parents=True, exist_ok=True)
        (out / "README.md").write_text(
            f"# {args.project}\n\nGenerated by Gitmancer for project type: {args.type}.\n",
            encoding="utf-8",
        )
        print(f"Generated baseline at {out}")
    
    
    if __name__ == "__main__":
        main()
    
  • workspace/skills/Gitmancer/templates/GOVERNANCE_CHECKLIST.md164 B2329e0ecce24upstream ↗
    - [ ] LICENSE
    - [ ] CONTRIBUTING.md
    - [ ] CODE_OF_CONDUCT.md
    - [ ] SECURITY.md
    - [ ] PR template
    - [ ] Issue templates
    - [ ] Dependabot/Renovate
    - [ ] CI workflows
    
  • workspace/skills/Gitmancer/templates/README.template.md97 B8ddf0fe2896bupstream ↗
    # {{PROJECT_NAME}}
    
    ## Why this project?
    ...
    
    ## Features
    ...
    
    ## Installation
    ...
    
    ## Usage
    ...
    
  • workspace/skills/Gitmancer/tests/test_generator.py40 B3ada1ee4e585upstream ↗
    def test_placeholder():
        assert True
    
  • workspace/skills/Gitmancer/tests/test_smoke.py34 B7252c68d0976upstream ↗
    def test_smoke():
        assert True
    

Plain-text copy, no login: /skill-bundles/guillermovzq-alchemical-agent-ecosystem-workspace-skills-gitmancer.md

// REPO STATS

1 stars
0 open issues
Last commit: 1mo ago