Agent skill
koa
Provides comprehensive guidance for Koa.js framework including middleware composition, context API, async/await patterns, and application structure. Use when the user asks about Koa, needs to create lightweight Node.js web applications, implement middleware, or build APIs with Koa.
Install this agent skill to your Project
npx add-skill https://github.com/partme-ai/full-stack-skills/tree/main/skills/nodejs-skills/koa
SKILL.md
When to use this skill
Use this skill whenever the user wants to:
- Build Node.js HTTP services with Koa and its onion-model middleware
- Configure routing (koa-router), body parsing, error handling, and static files
- Compose async middleware with
ctxandnextpatterns - Create lightweight REST APIs or web applications
How to use this skill
Workflow
- Create app — instantiate Koa and add middleware in order
- Add routing — use
@koa/routerfor route definitions - Handle errors — add error middleware at the top of the stack
- Deploy — run behind reverse proxy with HTTPS
Quick Start Example
const Koa = require('koa');
const Router = require('@koa/router');
const bodyParser = require('koa-bodyparser');
const app = new Koa();
const router = new Router();
// Error handling middleware (top of stack)
app.use(async (ctx, next) => {
try {
await next();
} catch (err) {
ctx.status = err.status || 500;
ctx.body = { error: err.message };
ctx.app.emit('error', err, ctx);
}
});
// Body parser
app.use(bodyParser());
// Routes
router.get('/api/items', async (ctx) => {
const items = await Item.findAll();
ctx.body = { items };
});
router.post('/api/items', async (ctx) => {
const { name, price } = ctx.request.body;
const item = await Item.create({ name, price });
ctx.status = 201;
ctx.body = item;
});
router.get('/api/items/:id', async (ctx) => {
const item = await Item.findById(ctx.params.id);
if (!item) {
ctx.throw(404, 'Item not found');
}
ctx.body = item;
});
app.use(router.routes());
app.use(router.allowedMethods());
app.listen(3000, () => console.log('Server running on port 3000'));
Onion Model Middleware
// Logging middleware — demonstrates onion execution order
app.use(async (ctx, next) => {
const start = Date.now();
await next(); // <-- downstream
const ms = Date.now() - start;
ctx.set('X-Response-Time', `${ms}ms`);
console.log(`${ctx.method} ${ctx.url} - ${ms}ms`);
});
Custom Middleware Example
// Authentication middleware
function requireAuth() {
return async (ctx, next) => {
const token = ctx.get('Authorization')?.replace('Bearer ', '');
if (!token) {
ctx.throw(401, 'Authentication required');
}
ctx.state.user = await verifyToken(token);
await next();
};
}
router.get('/api/profile', requireAuth(), async (ctx) => {
ctx.body = ctx.state.user;
});
Best Practices
- Use
async/awaitcorrectly withnext()— alwaysawait next()in middleware - Place error handling middleware at the top of the middleware stack
- Use
ctx.throw()for HTTP errors; listen toapp.on('error')for logging - Deploy behind a reverse proxy (nginx) with HTTPS in production
- Use
@koa/corsfor CORS configuration; keep middleware chain lean
Reference
- Official documentation: https://koajs.com/
Keywords
koa, Node.js, middleware, onion model, async/await, context, routing, REST API
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
ocrmypdf-batch
OCRmyPDF batch processing skill — process multiple PDFs, Docker automation, shell scripting, and CI/CD integration. Use when the user needs to OCR many PDFs, set up automated OCR pipelines, or integrate OCR into workflows.
ocrmypdf-optimize
OCRmyPDF optimization skill — compress PDFs, configure PDF/A output, JBIG2 encoding, and lossless optimization. Use when the user needs to reduce PDF file size, create archival PDF/A files, or optimize OCR output.
ocrmypdf-image
OCRmyPDF image processing skill — deskew, rotate, clean, despeckle, remove border from scanned documents. Use when the user needs to improve scanned PDF quality, fix skewed pages, remove noise, or clean up scanned documents before OCR.
ocrmypdf-api
OCRmyPDF Python API and plugin skill — use OCRmyPDF programmatically from Python, integrate with applications, and extend with plugins (EasyOCR, PaddleOCR, AppleOCR). Use when the user needs to call OCRmyPDF from Python code, build OCR pipelines, or use alternative OCR engines.
ocrmypdf
OCRmyPDF core skill — add searchable OCR text layer to scanned PDFs, convert images to searchable PDFs, support 100+ languages via Tesseract. Use when the user needs to OCR a PDF, make a scanned PDF searchable, or extract text from scanned documents.
svelte
Guides Svelte and SvelteKit development including reactive components, stores, transitions, lifecycle hooks, SSR, file-based routing, and deployment. Use when the user needs to build Svelte components, create SvelteKit applications, implement reactivity patterns, or configure Svelte with Vite.
Didn't find tool you were looking for?