---
type: project
status: active
source: git.alwisp.com
repo: jason/agents
repo_url: https://git.alwisp.com/jason/agents
language: Markdown
branch: main
tags: [repo, jason]
updated: 2026-05-29
---

# agents

**Repository:** [jason/agents](https://git.alwisp.com/jason/agents) · branch `main` · Markdown

## Summary

Portable drop-in markdown instruction suite for AI coding agents — provides AGENTS.md, skill index, routing hubs, and specialized skill files to copy into any repo

## Current status

Active. Synced from Gitea on 2026-05-29.

## Documentation overview

# Drop-In Agent Instruction Suite

This repository is a portable markdown instruction pack for coding agents.

Copy these files into another repository to give the agent:
- a root `AGENTS.md` entrypoint,
- a central skill index,
- category hubs for routing,
- specialized skill files for common software, docs, UX, marketing, and ideation tasks.

## Structure

- `AGENTS.md` - base instructions and routing rules
- `DEPLOYMENT-PROFILE.md` - agent-readable prefilled deployment defaults
- `INSTALL.md` - copy and customization guide for other repositories
- `PROJECT-PROFILE-WORKBOOK.md` - one-time questionnaire for staging defaults
- `SKILLS.md` - canonical skill index
- `ROUTING-EXAMPLES.md` - representative prompt-to-skill routing examples
- `hubs/` - category-level routing guides
- `skills/` - specialized reusable skill files

## Design Goals

- Plain markdown only
- Cross-agent portability
- Implementation-first defaults
- On-demand skill loading instead of loading everything every session
- Context-efficient routing for large skill libraries
- Prefilled deployment defaults without per-install questioning
- Repo-local instructions take precedence over this bundle

## Intended Workflow

1. The agent reads `AGENTS.md`.
2. The agent reads `DEPLOYMENT-PROFILE.md` when it is filled in.
3. The agent checks `SKILLS.md`.
4. The agent opens only the relevant hub and skill files for the task.
5. The agent combines multiple skills when the task spans several domains.

## Core Categories

- Software development
- Debugging
- Documentation
- UI/UX
- Marketing
- Brainstorming

## Notes

- Project file auto-created from repo documentation.