agents

Repository: 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

The agent reads AGENTS.md.
The agent reads DEPLOYMENT-PROFILE.md when it is filled in.
The agent checks SKILLS.md.
The agent opens only the relevant hub and skill files for the task.
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.

2.2 KiB Raw Permalink Blame History