# AI resources + toolkit
[Project: Tools maintenance](https://github.com/users/jamditis/projects/20)
A collection of AI tools, templates, and guides for journalists and developers. Created by **Joe Amditis** and hosted at **https://tools.amditis.tech/**
The resource kit is at version 2.8. The November 2, 2026 refresh updated
model recommendations, prices, terminal setup, and downloads. The
[AI model source register](resource-kit/docs/downloads/AI-MODEL-SOURCE-REGISTER.md)
records provider sources and the families still carrying August checks. Re-check
availability, pricing, privacy terms, and tool requirements before production use.
## Resource kit website
Interactive tools and guides built with love and frustration by Joe Amditis.
### Guides
| Page | Description |
|------|-------------|
| [Vibe coding guide](https://tools.amditis.tech/vibe-coding/) | Multi-page tutorial on AI-assisted development |
| [Terminal setup guide](https://tools.amditis.tech/terminal-setup/) | Step-by-step instructions for configuring AI CLI tools |
| [Language guide](https://tools.amditis.tech/language-guide/) | How to write effective prompts |
| [Style guide](https://tools.amditis.tech/style-guide/) | Writing style reference |
| [Next level guide](https://tools.amditis.tech/next-level/) | Agent workflows and techniques beyond the basics |
| [Quick reference card](https://tools.amditis.tech/quick-reference-card/) | Printable cheat sheet for common AI prompts |
| [Glossary](https://tools.amditis.tech/glossary/) | AI and development terminology |
### Tools
| Page | Description |
|------|-------------|
| [LLM Advisor](https://tools.amditis.tech/llm-advisor/) | Decision tree tool for selecting the right AI model for your task |
| [Tool stacks](https://tools.amditis.tech/tool-stacks/) | IDEs, AI app builders, databases, deployment, and 14 tool categories |
| [Claude plan savings calculator](https://tools.amditis.tech/cost-calculator/) | Compare estimated API costs with subscription plans; includes a cumulative-cost statusline snippet |
| [HTML editor](https://tools.amditis.tech/html-editor/) | Interactive HTML editor |
| [Code patterns](https://tools.amditis.tech/code-patterns/) | Skills, lessons, and quick reference for Claude Code workflows |
| [About](https://tools.amditis.tech/about/) | About the project and author |
### Browser extensions
Chrome and Edge extensions. Each installs from the Chrome Web Store and works in both browsers, since Edge adds Chrome Web Store extensions directly.
| Extension | Description |
|-----------|-------------|
| [LinkSweepr](https://tools.amditis.tech/linksweepr/) | Keeps the domains you choose out of your browsing history, automatically and on-device |
| [SocialSnag](https://tools.amditis.tech/socialsnag/) | Right-click to download full-resolution images and videos from Instagram, Twitter/X, Facebook, and Bluesky |
| [PocketLink](https://tools.amditis.tech/pocketlink/) | Turns the current page into a Bit.ly shortlink and copies it to your clipboard in one click |
### Vibe coding guide sections
The vibe coding guide is a multi-page resource:
- **Essentials** โ Core concepts for AI-assisted development
- **Level up** โ Advanced techniques and patterns
- **Common mistakes** โ Pitfalls to avoid
- **Cheat sheet** โ Quick reference for common tasks
- **Glossary** โ Key terms and definitions
### Downloadable templates
Available in `resource-kit/docs/downloads/`:
- CLAUDE-RULES templates (14 variants including frontend-aesthetics and writing-guidelines)
- LESSONS-TEMPLATE.md
- CLAUDE-CODE-QUICKREF.md
- VIBE-CODING-CHECKLIST.md
- LLM-COMPARISON.md
- CHANGELOG-TEMPLATE.md
---
## Claude Code skills
Reusable skills for Claude Code that extend its capabilities for specific workflows.
| Skill | Description | Link |
|-------|-------------|------|
| [test-first-bugs](./skills/test-first-bugs/) | Test-driven bug fixing workflow | Local |
| [pdf-design](./skills/pdf-design/) | PDF reports and proposals with interactive editing, brand system, budget tables | Local |
| [journalism skills](https://github.com/jamditis/claude-skills-journalism) | 76 skills, 14 plugins, and 17 hooks for journalism, media, and academia; Claude and Codex support | External repo |
### Installing plugins (recommended for PDF Playground)
```bash
claude plugin marketplace add https://github.com/jamditis/claude-skills-journalism
claude plugin install pdf-playground@claude-skills-journalism
```
Then restart Claude Code. See the [PDF Playground setup guide](https://github.com/jamditis/claude-skills-journalism/tree/master/pdf-playground#readme) for detailed instructions and troubleshooting.
### Installing skills (manual)
```bash
# Clone journalism skills collection
git clone https://github.com/jamditis/claude-skills-journalism.git ~/.claude/skills/journalism-skills
# Or copy individual skills
cp -r skills/pdf-design ~/.claude/skills/
```
---
## LESSONS.md templates
Templates for documenting project learnings, designed to carry forward wisdom without context bleed.
### Software development
| Template | Use for |
|----------|---------|
| `LESSONS-general.md` | Any project type (start here if unsure) |
| `LESSONS-desktop-app.md` | Electron, Tauri, native desktop apps |
| `LESSONS-browser-extension.md` | Chrome/Firefox/Edge extensions |
| `LESSONS-web-app.md` | React, Vue, static sites, SPAs |
| `LESSONS-data-pipeline.md` | Python scripts, ETL, scrapers, data processing |
| `LESSONS-mobile-app.md` | React Native, Capacitor, Flutter, native mobile |
### Journalism & publishing
| Template | Use for |
|----------|---------|
| `LESSONS-digital-archive.md` | Digital preservation, historical archives, collections |
| `LESSONS-event-website.md` | Conferences, summits, events with registration |
| `LESSONS-content-pipeline.md` | CMS workflows, publishing automation, syndication |
| `LESSONS-editorial-tool.md` | Newsroom tools, reporter/editor software |
| `LESSONS-research-project.md` | Investigations, data journalism, analysis projects |
| `LESSONS-publication.md` | Newsletters, blogs, ongoing content series |
---
## CLAUDE-RULES templates
Project memory files for Claude Code, providing context and guidelines for AI assistance.
### Software development
| Template | Use for |
|----------|---------|
| `CLAUDE-RULES-general.md` | Any project type |
| `CLAUDE-RULES-desktop-app.md` | Electron, Tauri, native apps |
| `CLAUDE-RULES-browser-extension.md` | Browser extensions |
| `CLAUDE-RULES-web-app.md` | Web applications |
| `CLAUDE-RULES-data-pipeline.md` | Data processing, ETL |
| `CLAUDE-RULES-mobile-app.md` | Mobile applications |
### Journalism & publishing
| Template | Use for |
|----------|---------|
| `CLAUDE-RULES-digital-archive.md` | Digital archives |
| `CLAUDE-RULES-event-website.md` | Event websites |
| `CLAUDE-RULES-content-pipeline.md` | Content automation |
| `CLAUDE-RULES-editorial-tool.md` | Editorial tools |
| `CLAUDE-RULES-research-project.md` | Research projects |
| `CLAUDE-RULES-publication.md` | Publications |
---
## Anime.js documentation
Full documentation for the Anime.js animation library (v4):
| File | Content |
|------|---------|
| `ANIMEJS-COMPLETE-DOCUMENTATION.md` | Full reference guide |
| `animejs-documentation.md` | Core API documentation |
| `animejs-timeline-documentation.md` | Timeline and sequencing |
| `animejs-stagger-documentation.md` | Stagger effects |
| `animejs-draggable-documentation.md` | Draggable elements |
| `animejs-scrollobserver-documentation.md` | Scroll-based animations |
| `animejs-waapi-documentation.md` | Web Animations API integration |
---
## Project structure
```
tools/
โโโ resource-kit/
โ โโโ docs/ # GitHub Pages (served from here)
โ โโโ index.html # Main landing page
โ โโโ about/ # About page
โ โโโ cost-calculator/ # Claude plan savings calculator
โ โโโ next-level/ # Agent workflow guide
โ โโโ code-patterns/ # Skills, lessons, quick reference
โ โโโ glossary/ # AI terminology glossary
โ โโโ html-editor/ # Interactive HTML editor
โ โโโ language-guide/ # Prompt writing guide
โ โโโ llm-advisor/ # LLM tool selector app
โ โโโ llm-advisor-doc/ # Static LLM documentation
โ โโโ quick-reference-card/ # Printable cheat sheet
โ โโโ style-guide/ # Writing style reference
โ โโโ terminal-setup/ # Terminal configuration guide
โ โโโ tool-stacks/ # Development tools (14 categories)
โ โโโ vibe-coding/ # Vibe coding guide (5 sub-pages)
โ โโโ downloads/ # Downloadable templates
โ โโโ assets/ # Shared CSS, JS, images
โโโ skills/ # Claude Code skills
โ โโโ test-first-bugs/ # Test-driven bug fixing workflow
โ โโโ pdf-design/ # PDF reports/proposals design system
โโโ hooks/ # Automated workflow hooks
โโโ LESSONS-*.md # Project retrospective templates (12)
โโโ CLAUDE-RULES-*.md # Claude Code memory templates (12)
โโโ animejs-*.md # Animation library documentation
โโโ mcp-servers/ # MCP server for LLM Advisor data
โโโ _archive/ # Frozen reference documents and design archives
โโโ scripts/ # Utility scripts
โโโ .github/workflows/ # GitHub Actions (auto-deploy)
```
---
## How to use
### Using templates
```bash
# Copy a template to your project
cp LESSONS-web-app.md /path/to/project/LESSONS.md
cp CLAUDE-RULES-web-app.md /path/to/project/CLAUDE.md
```
Or ask Claude Code:
> "Create a LESSONS.md for this project using the web-app template"
### Local development
```bash
cd resource-kit/docs
python -m http.server 8000
# Open http://localhost:8000
```
### Checks
Pull requests run [Content checks](.github/workflows/content-checks.yml) on
GitHub-hosted runners. The job runs the content/statusline and advisor attribute
tests, then validates the advisor JSON. It uses Node.js 22, Bash, and `jq`;
no dependency install or browser is needed.
This public repository uses hosted CI. Do not run tests, builds, lint, or type
checks on fleet machines. The hosted content job runs:
```bash
node --test scripts/ai-content-freshness.test.js scripts/advisor-attributes.test.js
node scripts/validate-all-json.js
```
The Tailwind build and MCP data-write tests are separate suites and are not part
of Content checks. See their [build notes](resource-kit/tailwind-build/README.md)
and [data validation notes](mcp-servers/llm-advisor-data/README.md).
### Deployment
Merge an approved PR into `master` to trigger the separate Pages deployment.
A passing PR content check does not confirm deployment.
```bash
# Check deployment status
gh run list --limit 3
```
---
## Template philosophy
### Focus on "the real problem"
Every template has a section for this. What did users actually need vs what you built? This insight transfers to future projects.
### Keep vs start fresh
Templates separate recommendations for continuing vs starting over. Both are valid paths.
### Artifacts worth keeping
Code dies, but patterns live. Identify files/components that could be extracted and reused.
---
## Choosing a template
**Building software?**
- Desktop app โ `desktop-app`
- Browser extension โ `browser-extension`
- Website/web app โ `web-app`
- Scripts/automation โ `data-pipeline`
- Mobile app โ `mobile-app`
**Journalism/publishing project?**
- Preserving content โ `digital-archive`
- Conference/event site โ `event-website`
- Content automation โ `content-pipeline`
- Newsroom tool โ `editorial-tool`
- Investigation/analysis โ `research-project`
- Newsletter/blog โ `publication`
**Not sure?** Start with `general` and adapt.
---
## License
MIT