Skip to content

Add ascii codebase diagramming skill - #747

Closed
d33disc wants to merge 28 commits into
anthropics:mainfrom
d33disc:add-ascii
Closed

d33disc wants to merge 28 commits into
anthropics:mainfrom
d33disc:add-ascii

Conversation

@d33disc

@d33disc d33disc commented Mar 23, 2026

Copy link
Copy Markdown

Summary

  • New /ascii skill that scans a codebase and generates aligned Unicode box-drawing architecture diagrams
  • Outputs numbered .txt files to ~/Downloads/<project>_architecture/ covering pipeline flows, module maps, data flows, file trees, and integration maps
  • Includes reference/glyph-palette.md with character set, alignment rules, self-check procedure, and skeleton templates
  • Added to example-skills group in marketplace.json

Test plan

  • Load skill in Claude Code session, run /ascii against a small repo
  • Verify output folder created in ~/Downloads/ with numbered .txt files
  • Verify 00_overview.txt index lists all diagrams
  • Verify box-drawing characters align correctly in monospaced font
  • Verify validate-skills CI workflow passes

🤖 Generated with Claude Code

Copilot AI and others added 28 commits March 13, 2026 14:45
This fork of `anthropics/skills` had no automation — staying in sync
required manual git work, and there was no visibility into what changed
or broke when histories diverged.

## What's added

### `.github/workflows/sync-upstream.yml`
Daily cron (06:00 UTC) + `workflow_dispatch` with a `dry_run` toggle.

| Scenario | Action |
|---|---|
| Already in sync | Exit cleanly |
| Upstream-only new commits | Fast-forward merge directly to `main` |
| Diverged histories | Open a labeled PR with full diff context |
| Merge conflicts in diverged PR | Stage conflict markers, list
conflicting files, apply `conflicts` label |

PR body includes a summary table, incoming commit log (up to 50),
changed-files list with status emoji (➕ ✏️ ➖ 🔀), and — when conflicts
exist — a per-file list with step-by-step resolve instructions.
Deduplicates: skips opening a new PR if one is already open.

### `.github/workflows/label-pr.yml` + `.github/labeler.yml`
Auto-labels every PR via `actions/labeler@v5` based on changed paths:
`skills`, `spec`, `template`, `documentation`, `github-actions`.

### `.github/labels.yml`
Label definitions (name, color, description) for all labels used by the
automations, including the new `conflicts` label (red) applied to sync
PRs with unresolved conflicts.

### `.github/CODEOWNERS`
Auto-requests `@d33disc` as reviewer on all PRs.

<!-- START COPILOT CODING AGENT TIPS -->
---

📍 Connect Copilot coding agent with [Jira](https://gh.io/cca-jira-docs),
[Azure Boards](https://gh.io/cca-azure-boards-docs) or
[Linear](https://gh.io/cca-linear-docs) to delegate work to Copilot in
one click without leaving your project management tool.
…rkdownlintignore and pip cache

Co-authored-by: d33disc <[email protected]>
…kills spec validation (#1)

- [x] Create `pyproject.toml` with ruff and mypy configuration
- [x] Create `.github/workflows/lint-typecheck.yml` — daily auto-fix
workflow (Python + Markdown)
- [x] Create `.markdownlint.json` — MD013.tables: false
- [x] Create `.github/workflows/validate-skills.yml` — Agent Skills spec
validation
- [x] **Fix critical mdformat bug**: `mdformat .` was destroying YAML
frontmatter in all SKILL.md files — now scoped with `find . -name "*.md"
! -name "SKILL.md"` so SKILL.md files are never touched by mdformat
- [x] **Pin all tool versions**: `ruff==0.15.6`, `mypy==1.19.1`,
`mdformat==0.7.22`, `mdformat-tables==1.0.0`, `[email protected]`
— reproducible builds
- [x] **Create `.markdownlintignore`**: excludes
`THIRD_PARTY_NOTICES.md` (auto-generated licence text with 130+
false-positive violations); both auto-fix and report-only markdownlint
steps pass `--ignore-path .markdownlintignore`
- [x] **Add pip caching**: `cache: pip` on setup-python — avoids
re-downloading tools on every daily run
- [x] **Expand validate-skills path trigger**: now also fires when
`scripts/**`, `references/**`, or `assets/**` change — catches broken
file references after a rename/delete

<!-- START COPILOT CODING AGENT TIPS -->
---

🔒 GitHub Advanced Security automatically protects Copilot coding agent
pull requests. You can protect all pull requests by enabling Advanced
Security for your repositories. [Learn more about Advanced
Security.](https://gh.io/cca-advanced-security)
LuaLaTeX typography toolkit implementing Tufte-grade Swiss micro-typography:
12pt baseline grid, perfect fourth type scale (9/12/16/21pt), four-gray
hierarchy, microtype paragraph building with hanging punctuation and glyph
expansion.

Includes portable .sty package, Lua grid-snap engine, example template,
typography spec reference, and smoke test script.

Co-authored-by: Claude Opus 4.6 (1M context) <[email protected]>
* Fix xlsx SKILL.md frontmatter: add YAML --- markers

The frontmatter was malformed (horizontal rule instead of --- markers,
all fields on one line). This caused the Validate Agent Skills CI to
fail on every push.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>

* Fix broken YAML frontmatter in 16 skills

All had horizontal rules instead of --- markers and metadata jammed on
a single line, causing Validate Agent Skills CI to fail on every push.

Fixed: algorithmic-art, brand-guidelines, canvas-design, claude-api,
doc-coauthoring, docx, frontend-design, internal-comms, mcp-builder,
pdf, pptx, skill-creator, slack-gif-creator, theme-factory,
web-artifacts-builder, webapp-testing

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <[email protected]>
* Add local-only skills (git-workflow, tdd), agents, and Makefile

- skills/git-workflow: branch strategy and atomic commit workflow
- skills/tdd: red-green-refactor TDD workflow
- agents/tangent.md: ADHD/focus support agent
- agents/reality-check.yaml: brutal honesty agent
- Makefile.skills: package skills for claude.ai upload

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>

* Add YAML frontmatter to git-workflow and tdd skills

CI requires --- markers with name and description fields.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <[email protected]>
Bump GitHub Actions to Node.js 24 and fix wiki deploy

- actions/checkout v4 → v6
- actions/setup-python v5 → v6
- actions/labeler v5 → v6
- Wiki deploy: warn instead of failing when wiki repo is uninitialized

Co-authored-by: Claude Opus 4.6 (1M context) <[email protected]>
… add ignore paths, expand triggers

Co-authored-by: d33disc <[email protected]>
…rmat scope, wire up ignore paths (#8)

PR #1 merged with 6 unresolved review comments where the implementation
didn't match the stated intent. This PR fixes all of them.

### `lint-typecheck.yml`

- **Pin tool versions** for reproducible builds: `ruff==0.15.6`,
`mypy==1.19.1`, `mdformat==0.7.22`, `mdformat-tables==1.0.0`,
`[email protected]`
- **Add `cache: pip`** to `setup-python` step
- **Fix mdformat destroying YAML frontmatter** in SKILL.md files —
`mdformat .` replaced with:
  ```bash
  find . -name "*.md" ! -name "SKILL.md" -print0 | xargs -0 mdformat
  ```
- **Wire up `.markdownlintignore`** — add `--ignore-path
.markdownlintignore` to both the auto-fix and report-only markdownlint
steps

### `validate-skills.yml`

- **Expand path triggers** to also fire on `scripts/**`,
`references/**`, `assets/**` changes (catches broken file references
after renames/deletes)

<!-- START COPILOT CODING AGENT TIPS -->
---

💡 You can make Copilot smarter by setting up custom instructions,
customizing its development environment and configuring Model Context
Protocol (MCP) servers. Learn more [Copilot coding agent
tips](https://gh.io/copilot-coding-agent-tips) in the docs.
…factor (#9)

- Add `nofonts` package option to tufte-swiss.sty for custom font families
- Fix fontspec "Could not resolve" warnings by declaring all four faces
  (BoldFont/BoldItalicFont) on every \newfontfamily, mapping single-weight
  families to next heavier weight in Aktiv Grotesk
- Add references/FONT_REFERENCE.md: fc-list discovery, four-face rule,
  font pairing principles, optical sizes, LuaLaTeX compilation, troubleshooting
- Refactor SKILL.md: proper YAML frontmatter, 133 lines (was 258+121),
  progressive disclosure with references/ for deep docs
- Delete redundant ORIENTATION.md (merged into SKILL.md)

Co-authored-by: Claude Opus 4.6 (1M context) <[email protected]>
chore: add .gitignore, symlink ToolUniverse skills from source repo

- Add .gitignore for LaTeX artifacts, Python cache, OS junk
- Ignore ToolUniverse skill dirs (symlinked from ~/code/ToolUniverse/skills/)
- 69 plain-copy dirs replaced with symlinks to single source of truth
- upstream_skills tracks only Anthropic marketplace + 3 custom skills

Co-authored-by: Claude Opus 4.6 (1M context) <[email protected]>
chore: remove slack-gif-creator skill

Unused. Saves ~48 description tokens per message.

Co-authored-by: Claude Opus 4.6 (1M context) <[email protected]>
Scan any codebase and generate aligned Unicode box-drawing architecture
diagrams. Produces numbered .txt files in ~/Downloads/<project>_architecture/
covering pipeline flows, module maps, data flows, file trees, and
integration maps.

Includes reference/glyph-palette.md with character set, alignment rules,
self-check procedure, and skeleton templates for each diagram type.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants