AI Agents - lesson 7 | HackIndia Skills

AI Agents - lesson 7 | HackIndia Skills | HackIndia

Example

README skeleton

Use this as your minimum README. Replace the placeholders with your project details. Keep it honest if some features are basic.

Project: Campus Reimbursement Helper

What it does
Helps a student prepare a reimbursement request from bill details. It can read structured input, calculate totals, draft a message, and ask before sending anything.

How to run
1. Install dependencies.
2. Add required environment variables.
3. Run the agent with a sample request.

Safety features
- Tool schemas are in: src/tools/
- Call-result loop is in: src/agent_loop.py
- Approval gate is used before: sending the final email
- Hard limits used: max turns and tool call budget
- Risky actions are not run without human approval

When I would replace this with a script
I would use a script if the steps are fixed: read a CSV, calculate totals, fill a template, and save a PDF. I use an agent only when the request needs judgement, such as asking follow-up questions or choosing which tool to call.

Tip

Use AI carefully

Ask an AI assistant to review your repo before submission. Give it the checklist and ask what is missing.

Then verify the answer yourself. AI may claim that a limit or approval gate exists when it only appears in comments.

Prompt to use:
Review this repo for a hackathon submission. Check whether it clearly shows:
1. tool schemas
2. a call-result loop
3. a human approval gate
4. hard limits
5. a note on when a script is better
Return missing items with file names. Do not guess.

Ship the repo project

One review rule

What to ship

Repo checklist

README skeleton

Common submission mistake

Use AI carefully

Do this now

Quick check