How to create an AI agent: from instructions to connected work

4 min readUpdated Skillshop operator and creator of the Maker Evan YouTube channel

Translated from Korean. View original. Some screenshots are available in Korean only.

You can start creating an AI agent by connecting work instructions and materials to an existing tool. For example, specify inputs, drafting steps and review checks for a weekly report. If scheduled execution or external services become necessary, consider adding a workflow tool or code.

Browse relevant skills and examples on Skillshop.

View original Korean screenshot
스킬샵의 자동화 AI 스킬 카테고리 화면. 업무와 채널 자동화를 다루는 스킬 카드가 격자로 놓여 있다.
스킬샵에서 관련 작업의 스킬과 사용 예시를 살펴볼 수 있어요.

Define the work to delegate

You can configure work with existing tools without training an AI model from scratch. Start by defining what to read, in what order to process it and where to save results.

A reporting agent, for example, needs source locations, aggregation rules, report format and review steps. Check that the tool’s features and permissions support the task.

Instructions, connections and recordsDefine the procedure, materials and saved result.
AgentProcesses files using supported tools and permissions.
ModelInterprets inputs and proposes responses and actions.
Existing tools can configure a task without training a model from scratch.

Choose instructions, a workflow or code

Add instructions or a skill to an existing AI tool to convey a repeatable method. Start by combining supported features such as file handling.

Consider a workflow tool for scheduled execution or branching. If you need integrations or controls beyond existing features, implement them in code. Check export, operations and maintenance requirements for each approach.

ApproachWhat you configureWhat to check
Instructions or skillRecord repeated steps and criteria.Does the existing tool support the required features?
Workflow toolSet up scheduled and conditional flows.Check features, export and operating terms.
CodeImplement integrations and detailed control.Prepare an execution environment and maintenance plan.
Try a small task to distinguish what instructions can do from missing capabilities.
Add instructionsUse existing toolsCombine supported functions through instructions.
Connect blocksVisual workflowConfigure a flow on screen; export differs by service.
Write codeDetailed controlImplement and maintain the features you need.
Instructions or skills can convey a repeatable method to an existing tool.
Create your first subagent in Anthropic's English documentation
An example from the official documentation. Check the current linked setup guide.Source: Claude Code documentation
Open full-size image (opens in a new tab)
View original Korean screenshot
한국어 문서의 '빠른 시작: 첫 번째 subagent 만들기' 페이지다. 1단계에 code-improver subagent 생성을 요청하는 프롬프트 코드 블록이, 2단계에 파일 검토가 온다.
공식 문서의 화면 예시예요. 현재 설정은 연결된 공식 안내에서 확인해 주세요.출처: 클로드 코드 공식 문서 · subagent

Start with one task you can explain

Choose work for which you can show example inputs and expected results. Write the steps and run them with a real tool to identify where instructions suffice and where extra capabilities are needed.

Instructions do not make every action possible. Check whether you need file access, installed programs or external connections, then choose the next approach for the blocked step.

Suitable for instructions
  • You can explain the work to a person
  • The sequence is mostly consistent
  • You can verify the result
Not yet ready
  • Exceptions dominate the explanation
  • Judgment varies substantially each time
  • The result has never been checked
Choose a task with example inputs and expected outputs.

Prepare instructions, materials and prior records

Use instructions to convey your team’s report sequence or prohibited wording. Provide internal material through authorized connections or files and define the permitted scope.

If later work needs previous decisions and results, save them in a file or storage feature. Check that records are actually loaded and stale information is not mixed in.

What it readsInstructions: your sequence and prohibited actions.
Where it can reachConnections to internal material and services.
MemoryWhether prior decisions and results are recorded.
Convey the team’s work sequence and boundaries in instructions.

Run the first task and record differences

Write the prerequisites, sequence and completion criteria and try a small input. Compare expected and actual results to find missing steps.

Add examples if instructions were vague; address missing tools or permissions separately. Keep a successful input and result to check future revisions against the same criteria.

Choose one taskFor example, work repeated at least three times this week.
Write the sequenceWhat to read and check, and where to stop.
Try onceDistinguish instruction issues from environment issues.
Fix the causeRetest with the same input after a change.
Record prerequisites, steps and completion criteria, then try a small input.

Check both instruction loading and the environment

If a skill was not selected, check its description, invocation method and location. If it was read but something is missing, check whether important rules are clear or conflict with other instructions.

Split long references into material read when needed and add examples of expected results. Authentication and program errors cannot always be solved by documentation, so inspect the actual failure message.

Not selectedDescriptionDoes the opening say when to use it in familiar terms?
Too longShortenSeparate core rules from detailed references.
AmbiguousSpecifyReplace vague instructions with checkable values.
No checkAdd oneDescribe what a correct result looks like.
If a skill is not selected, check its description, invocation and location.

Share it so teammates can follow

Alongside the instruction file, share required tools, input examples, execution steps and expected results. A teammate trying it in a new environment can find missing setup.

Record changes and dates and establish a shared source to reduce version drift. Before adapting a public skill, check its usage terms and execution scope.

Instruction fileRecord your work sequence.
Shared locationPut the file somewhere the team can find.
Team useFollow the same sequence.
UpdateChanges inform subsequent work.
Share required tools, examples, execution steps and expected results too.

Frequently asked questions

Do I need to code to build an AI agent?

You can start by combining features supported by an existing tool through instructions or a skill. Consider workflow tools for schedules or branching and code for additional integrations or control. It depends on the features needed.

What should my first agent do?

Choose a repeated task with example inputs and expected output. Record prerequisites, steps and completion criteria and run a small example. Separate instruction problems from missing tools or permissions.

What if the agent does not follow my instructions?

Check that the file was selected and read. Clarify important rules, check conflicts and provide an expected-output example. Inspect failure messages too; authentication and program errors may need separate fixes.

Sources