digital-ai-finance-organization-manager

Organization management utilities for Digital-AI-Finance - analysis, fixing, analytics, landing page generation

Information

Property	Value
Language	Python
Stars	0
Forks	0
Watchers	0
Open Issues	0
License	MIT License
Created	2025-12-14
Last Updated	2026-02-24
Last Push	2026-02-24
Contributors	1
Default Branch	main
Visibility	private

Reproducibility

This repository includes reproducibility tools:

Python requirements.txt

Status

Issues: Enabled
Wiki: Enabled
Pages: Enabled

README

Organization Manager

Organization-wide utilities for managing, analyzing, and maintaining GitHub repositories across the Digital-AI-Finance organization.

Features

Repository Analysis: Health, quality, and publication readiness metrics
Auto-Fix: Automatically fix common issues (LICENSE, README)
Site Detection: Identify Jekyll, Hugo, MkDocs, and other frameworks
Landing Page: Auto-generate organization landing page
Analytics: Deploy Cloudflare Workers for page view tracking

Installation

# Clone the repository
git clone https://github.com/Digital-AI-Finance/digital-ai-finance-organization-manager.git
cd digital-ai-finance-organization-manager

# Install as package
pip install -e .

# Or install dependencies only
pip install -r requirements.txt

Commands

Full Organization Scan

org-manager scan --org Digital-AI-Finance

Analyzes all repositories for health, quality, and publication readiness. Generates JSON, HTML, and Markdown reports.

Health Metrics

org-manager health --org Digital-AI-Finance
org-manager health --org Digital-AI-Finance --repos repo1 repo2

Checks: - Commit activity (days since last commit, 90-day count) - Community engagement (stars, forks, contributors) - Issue management (open issues, stale issues) - Branch protection status

Quality Metrics

org-manager quality --org Digital-AI-Finance

Checks: - Test coverage (test directories, test frameworks) - CI/CD configuration (GitHub Actions, Travis, etc.) - Linting tools (flake8, pylint, ESLint, etc.) - Documentation quality

Publication Readiness

org-manager publish --org Digital-AI-Finance

Checks: - README completeness - CITATION.cff presence - DOI availability - QuantLet metadata (for research repos)

Cross-Repo Patterns

org-manager patterns --org Digital-AI-Finance

Analyzes: - Shared dependencies across repos - License consistency - Language distribution - Framework adoption

Auto-Fix Issues

# Preview changes (dry-run)
org-manager fix --org Digital-AI-Finance --dry-run

# Apply fixes
org-manager fix --org Digital-AI-Finance

Automatically fixes: - Missing MIT LICENSE files - Incomplete README files (adds sections)

Site Framework Detection

org-manager sites --org Digital-AI-Finance
org-manager sites --org Digital-AI-Finance --output sites.json

Detects: - Jekyll (including GitHub's default theme) - Hugo - MkDocs - Sphinx - Plain HTML

Landing Page Generation

# Generate locally
org-manager landing-page --org Digital-AI-Finance --output index.html

# Generate and push to org.github.io
org-manager landing-page --org Digital-AI-Finance --push

Creates a responsive HTML page with: - Repository cards with site type badges - Search/filter functionality - Summary statistics - Links to GitHub Pages sites

Analytics (Cloudflare Workers)

# Scan repos for GitHub Pages
org-manager analytics scan --org Digital-AI-Finance

# Deploy tracking workers
org-manager analytics deploy --org Digital-AI-Finance
org-manager analytics deploy --org Digital-AI-Finance --dry-run

# Inject tracking into HTML files
org-manager analytics inject --org Digital-AI-Finance

# Generate tracking snippet for manual insertion
org-manager analytics snippet --repo repo-name

Tracks page views and PDF downloads, stores data in GitHub Issues.

Configuration

GitHub Token

The tool uses GitHub authentication in this order: 1. --token command line argument 2. gh auth token (GitHub CLI) 3. GITHUB_TOKEN environment variable

For full functionality (including fixes and analytics), use a token with repo scope.

Cloudflare (for analytics)

Create ~/.claude/user-config.json:

{
  "github": {
    "token": "ghp_..."
  },
  "cloudflare": {
    "account_id": "YOUR_ACCOUNT_ID",
    "api_token": "YOUR_API_TOKEN"
  }
}

Output Formats

All scan commands generate: - Console: Summary output with pass/fail status - JSON: Machine-readable data (org_report.json) - HTML: Interactive dashboard (org_report.html) - Markdown: Documentation-friendly format (org_report.md)

Scoring

Each check returns a score from 0.0 to 1.0: - Pass (>= 70%): Repository meets standards - Warning (50-70%): Needs improvement - Fail (< 50%): Critical issues

Package Structure

org_manager/
├── __init__.py
├── cli.py                    # Unified CLI entry point
├── github_client.py          # GitHub API client
├── cache.py                  # JSON-based caching
├── report_generator.py       # HTML/JSON/Markdown output
├── analyzers/
│   ├── health_analyzer.py    # Repository health metrics
│   ├── quality_analyzer.py   # Code quality analysis
│   ├── publish_analyzer.py   # Publication readiness
│   └── pattern_analyzer.py   # Cross-repo patterns
├── tools/
│   ├── org_fixer.py          # Auto-fix utilities
│   ├── cf_analytics.py       # Cloudflare analytics
│   ├── site_detector.py      # Framework detection
│   └── landing_page_generator.py
└── templates/
    └── worker_template.js    # Cloudflare Worker template

Requirements

Python 3.9+
requests >= 2.28.0
jinja2 >= 3.1.0

License

MIT License - see LICENSE file for details.

Contributing

Fork the repository
Create a feature branch
Make your changes
Submit a pull request

Digital-AI-Finance - GitHub organization
digital-ai-finance.github.io - Organization landing page

Description

Organization management utilities for Digital-AI-Finance - analysis, fixing, analytics, landing page generation

Usage

See the repository contents for usage examples.

Course Creator Skills

A comprehensive skill system for Claude Code that automates the creation of complete academic course websites. Given a YAML manifest (course.yaml), the orchestrator runs a 7-stage pipeline to produce LaTeX Beamer slides (6 PDF variants), charts, image galleries, HTML lecture pages, interactive quizzes, project tracks, and a deployable GitHub Pages site.

Skill Inventory

Skill	Role	Lines
`course-creator.md`	Parent orchestrator, manifest schema, 7-stage pipeline	891
`course-creator-slides.md`	Stage 1: LaTeX Beamer .tex generation	278
`course-creator-charts.md`	Stage 2: Chart scripts + PDF compilation	180
`course-creator-galleries.md`	Stage 3: PDF-to-PNG gallery pages	491
`course-creator-lectures.md`	Stage 4: HTML lecture pages with KaTeX	695
`course-creator-quizzes.md`	Stage 5: Interactive quiz pages	329
`course-creator-projects.md`	Stage 6: Project track pages	613
`course-creator-deploy.md`	Stage 7: GitHub Pages deployment	301
`beamer-slide-creator.md`	Beamer architecture, chart types, section frameworks	1736
`full-lecture-generator.md`	Full ~30-slide lecture with 10-role arc	900
`mini-lecture-generator.md`	5/10-slide mini-lectures	583

Quick Install

python scripts/install_skills.py --verbose

This creates symlinks so git pull automatically updates all skills. No re-installation needed.

Documentation

Full documentation available at: Course Creator Skills Documentation

Reference Implementation

See the Blockchain course for a live example with 12 lectures, 72 PDFs, and 144+ charts.

(c) Joerg Osterrieder 2025

digital-ai-finance-organization-manager

Information

Reproducibility

Status

README

Organization Manager

Features

Installation

Commands

Full Organization Scan

Health Metrics

Quality Metrics

Publication Readiness

Cross-Repo Patterns

Auto-Fix Issues

Site Framework Detection

Landing Page Generation

Analytics (Cloudflare Workers)

Configuration

GitHub Token

Cloudflare (for analytics)

Output Formats

Scoring

Package Structure

Requirements

License

Contributing

Related

Description

Usage

Course Creator Skills

Skill Inventory

Quick Install

Documentation

Reference Implementation