# gitmancer

Adopt this skill: https://proskills.md/skills/other/guillermovzq-alchemical-agent-ecosystem-workspace-skills-gitmancer

Page: https://proskills.md/skills/other/guillermovzq-alchemical-agent-ecosystem-workspace-skills-gitmancer
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: workspace/skills/Gitmancer/SKILL.md
size: 1157
sha: 60e8585a1fea35ba508c721817775f25a07c5afb
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/SKILL.md

```text
---
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`
```

## File: workspace/skills/Gitmancer/README.md
size: 1084
sha: e1734d03c261d29f2babff05ffad28ba14a72bf2
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/README.md

````text
# 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
````

## File: workspace/skills/Gitmancer/assets/branding/logo.svg
size: 583
sha: 1c3634960c3a1f3a39d47718cf91778d0001e173
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/assets/branding/logo.svg

```text
<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>
```

## File: workspace/skills/Gitmancer/.github/CODEOWNERS
size: 9
sha: d6b9b1ad1aff16412009b66a31b7106f8466c5a2
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/.github/CODEOWNERS

```text
* @smouj
```

## File: workspace/skills/Gitmancer/.github/ISSUE_TEMPLATE/bug_report.md
size: 121
sha: 6a5565fb7a3af351fc500c5210f4d4a15192d53c
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/.github/ISSUE_TEMPLATE/bug_report.md

```text
---
name: Bug report
about: Report a reproducible issue
---

## Description

## Steps to reproduce

## Expected behavior
```

## File: workspace/skills/Gitmancer/.github/ISSUE_TEMPLATE/feature_request.md
size: 122
sha: 9a5c4a47406bd396b47f96322b9e6d64314b68ab
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/.github/ISSUE_TEMPLATE/feature_request.md

```text
---
name: Feature request
about: Suggest an improvement
---

## Problem

## Proposed solution

## Alternatives considered
```

## File: workspace/skills/Gitmancer/.github/pull_request_template.md
size: 93
sha: 731d9a11a62a673772832f9de2eeafbbb0cc5197
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/.github/pull_request_template.md

```text
## Summary

## Changes

## Validation
- [ ] lint
- [ ] test
- [ ] build

## Risks / Rollback
```

## File: workspace/skills/Gitmancer/.github/workflows/ci.yml
size: 311
sha: 2f9f5048ed60d1058690e19025c26c4b735b7a38
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/.github/workflows/ci.yml

```text
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
```

## File: workspace/skills/Gitmancer/.gitignore
size: 41
sha: fa106b98f6f4cb48b11e95c3c05e473b10a64dfd
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/.gitignore

```text
__pycache__/
*.pyc
.venv/
out/
.DS_Store
```

## File: workspace/skills/Gitmancer/CHANGELOG.md
size: 201
sha: 6d9ca310797028c2c9940d27b5e517f57c38674b
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/CHANGELOG.md

```text
# 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.
```

## File: workspace/skills/Gitmancer/CODE_OF_CONDUCT.md
size: 98
sha: 7908d09b1e990cab648951907146beea6adcae3e
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/CODE_OF_CONDUCT.md

```text
# Code of Conduct

This project follows the Contributor Covenant. Be respectful and constructive.
```

## File: workspace/skills/Gitmancer/CONTRIBUTING.md
size: 158
sha: 1fe52a8ba72585e3783f095aeaaba6a20e04b435
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/CONTRIBUTING.md

```text
# Contributing

## Branching
- feat/*
- fix/*
- chore/*

## Commit convention
Use Conventional Commits.

## Validation
Run lint/test/build before opening PR.
```

## File: workspace/skills/Gitmancer/docs/ARCHITECTURE.md
size: 183
sha: 05d93348455ed053f843b7f966b8afcc6aec62f3
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/docs/ARCHITECTURE.md

```text
# Architecture

Gitmancer provides:
- A reusable skill definition (`SKILL.md`)
- Repository templates and governance checklists
- A lightweight generator CLI (`src/gitmancer/cli.py`)
```

## File: workspace/skills/Gitmancer/docs/BRANDING.md
size: 82
sha: 99b3ece4b6d55552969e98b7975e51ea88325e74
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/docs/BRANDING.md

```text
# Branding

Primary logo: `assets/branding/logo.svg`
Theme: dark alchemy gradient
```

## File: workspace/skills/Gitmancer/docs/DEPLOYMENT.md
size: 79
sha: 4ff2b18b7689250d7cee00bea94364d0d441be0f
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/docs/DEPLOYMENT.md

```text
# Deployment

Gitmancer is source-distributed. No runtime deployment required.
```

## File: workspace/skills/Gitmancer/docs/IMPLEMENTATION.md
size: 147
sha: a6deac7e5e4f5356a9acf3bf6bd9621e8037b2b6
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/docs/IMPLEMENTATION.md

```text
# Implementation Guide

1. Define project context.
2. Generate repository baseline.
3. Apply governance and CI templates.
4. Validate and iterate.
```

## File: workspace/skills/Gitmancer/docs/PLAYBOOK.md
size: 265
sha: 18bc736a26bff1018736ea2d4f370a2d46f85414
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/docs/PLAYBOOK.md

```text
# 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.
```

## File: workspace/skills/Gitmancer/docs/RELEASE.md
size: 79
sha: 0f5a586b291bf1106b643d44d489ab5e884863f9
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/docs/RELEASE.md

```text
# Release

- Update CHANGELOG
- Tag release
- Publish repository documentation
```

## File: workspace/skills/Gitmancer/docs/RUNBOOK.md
size: 105
sha: 398c20f7e7cb72adcfbc38c1f9938392e12b82b6
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/docs/RUNBOOK.md

````text
# Runbook

## Local test
```bash
python -m src.gitmancer.cli --project "Demo" --type app --out ./out
```
````

## File: workspace/skills/Gitmancer/LICENSE
size: 1062
sha: eeded2b88af912d4e5b5a459ebdb0f7ca7aa0629
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/LICENSE

```text
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.
```

## File: workspace/skills/Gitmancer/README.es.md
size: 96
sha: 54919c2f238328e354774e88c0cfda2d898d1cf6
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/README.es.md

```text
# Gitmancer

Skill y toolkit para crear repositorios GitHub profesionales con estándares 2026.
```

## File: workspace/skills/Gitmancer/requirements.txt
size: 32
sha: 3a09422267b206263a423227833bc7bc99509bbb
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/requirements.txt

```text
# Runtime intentionally minimal
```

## File: workspace/skills/Gitmancer/SECURITY.md
size: 120
sha: ca1c19c1ed29ac10eb333fa28217785c4943b5f4
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/SECURITY.md

```text
# Security Policy

Report vulnerabilities privately to the maintainers.
Do not open public issues with exploit details.
```

## File: workspace/skills/Gitmancer/src/generator.py
size: 74
sha: a447b8f72f741b4a1f8848307dca564d5d0ca438
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/src/generator.py

```text
from src.gitmancer.cli import main

if __name__ == "__main__":
    main()
```

## File: workspace/skills/Gitmancer/src/gitmancer/__init__.py
size: 19
sha: 470d6936454190adda5f3ae7ce092d1a10df8745
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/src/gitmancer/__init__.py

```text
__all__ = ["main"]
```

## File: workspace/skills/Gitmancer/src/gitmancer/cli.py
size: 563
sha: 19911175fdec2f32216ebc05bb56b6f1b5b93567
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/src/gitmancer/cli.py

```text
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()
```

## File: workspace/skills/Gitmancer/templates/GOVERNANCE_CHECKLIST.md
size: 164
sha: 2329e0ecce24ffeee330bb4fd9ce990046993f75
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/templates/GOVERNANCE_CHECKLIST.md

```text
- [ ] LICENSE
- [ ] CONTRIBUTING.md
- [ ] CODE_OF_CONDUCT.md
- [ ] SECURITY.md
- [ ] PR template
- [ ] Issue templates
- [ ] Dependabot/Renovate
- [ ] CI workflows
```

## File: workspace/skills/Gitmancer/templates/README.template.md
size: 97
sha: 8ddf0fe2896bdad97d424bda1172608371d228dc
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/templates/README.template.md

```text
# {{PROJECT_NAME}}

## Why this project?
...

## Features
...

## Installation
...

## Usage
...
```

## File: workspace/skills/Gitmancer/tests/test_generator.py
size: 40
sha: 3ada1ee4e585a4b2664b66ace385ea172f9e769e
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/tests/test_generator.py

```text
def test_placeholder():
    assert True
```

## File: workspace/skills/Gitmancer/tests/test_smoke.py
size: 34
sha: 7252c68d0976c8334489a17271d4b09b6c8a678a
upstream: https://github.com/guillermovzq/alchemical-agent-ecosystem/blob/main/workspace/skills/Gitmancer/tests/test_smoke.py

```text
def test_smoke():
    assert True
```
