> For the complete documentation index, see [llms.txt](https://docs.senseloaf.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.senseloaf.ai/hiring-agents/job-writing-agent.md).

# Job Writing Agent

The Job Writing Agent is where every hiring workflow on Senseloaf begins. It reads whatever you give it, a quick description, a pasted JD, or an uploaded document, and turns it into a clean, structured job configuration that powers everything downstream: resume matching, prescreening, interviews, and automation.

You don't fill out long forms. You just describe the role, and SIA handles the rest.

{% hint style="warning" %}
**Note:** If your organization has connected Senseloaf to an ATS or HRIS, this step can be skipped — jobs will sync automatically and don't need to be created manually.
{% endhint %}

### What this agent does

* Helps you define a job role through AI, paste, or file upload
* Automatically generates a structured job configuration from your input
* Passes job context to all downstream agents (Resume Matching, Prescreening, Interviews)

<figure><img src="/files/RhwJCmN0YH0UCdO9BEtO" alt=""><figcaption><p>Job Writing Agent</p></figcaption></figure>

#### Defining your job role

There are two ways to create your job description. Pick whichever fits your situation best.

**Option 1 — Write with AI**&#x20;

<figure><img src="/files/uGWeIO3gtc9rYpM7ZESt" alt=""><figcaption><p>Write with AI</p></figcaption></figure>

Describe the role in plain language and let AI generate a full job description for you. You don't need to write anything formal, just tell Senseloaf what you're looking for, and it'll build the JD from there.

**How to use it:**

1. Select **Write with AI**
2. Type a short description of the role in the prompt field
3. Hit the arrow — Senseloaf will create a complete, structured job description

**Example prompt:**

> *"Hiring a Customer Success Manager with 3–6 years of experience handling enterprise SaaS customers in Seattle."*

That's all you need. Senseloaf will fill in responsibilities, requirements, and everything else based on your input.

{% hint style="info" %}
Be specific about experience range, location, and any non-negotiables — the more context you give, the more accurate the output.
{% endhint %}

**Option 2 — Upload a job document**

<figure><img src="/files/k4mAscklQQO4ZluwtSMs" alt=""><figcaption><p>Upload Job Document</p></figcaption></figure>

Prefer to work from a file? Upload your job document directly and Senseloaf will read it and extract the job details automatically.

**How to use it:**

1. Select **Upload a Job Document**
2. Upload your file
3. Senseloaf reads the document and builds the job configuration from it

{% hint style="info" %}
**Supported formats:** All major file formats are supported
{% endhint %}

### Reviewing and editing the generated job

Once Senseloaf processes your input, regardless of which option you used, it generates a structured job configuration you can review and refine before moving on.

<figure><img src="/files/EykDwYK0TLfwFXQukGHH" alt=""><figcaption><p>Review/Edit generated job</p></figcaption></figure>

You can edit any part of the output directly. If something doesn't look right or you want to add more detail, update it here before continuing to the next step.

{% hint style="warning" %}
The job configuration you finalise here becomes the foundation for your entire workflow. The Resume Matching strategy, Prescreening questions, and Interview questions are all generated based on this — so it's worth taking a moment to get it right.
{% endhint %}

### What happens next

Once you're happy with the job configuration, you move on to the next step in your workflow — setting up the agents that will evaluate candidates.

The job context you've defined here carries through automatically. You won't need to re-enter role details at any later stage.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.senseloaf.ai/hiring-agents/job-writing-agent.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.