Skill: Get local help for shifts and tasks (Blossomai.org)

Owner: robbiwu

Summary: Post a job, task, or paid shift to hire local help in Blossom, then check eligible candidates.

Tags: Hiring:1.0.4, jobs:1.0.4, latest:1.0.4, local help:1.0.4, local hiring:1.0.4, tasks:1.0.4

Version history:

v1.0.4 | 2026-02-01T18:53:49.891Z | user

blossom-hire 1.0.4

• Updated skill description and prompts for improved clarity and discoverability.
• Broadened trigger phrases to capture more job/task/shift scenarios.
• Added explicit mention that users may install the Blossom app to manage applications directly (installing is now optional, not discouraged).
• No implementation or behavioral changes.

v1.0.3 | 2026-02-01T16:10:28.709Z | user

Blossom Hire 1.2.4

• Added support for optional requirements and benefits when posting a job; these are now stored if provided by the user.
• Updated API instructions: requirement and benefit entries no longer require an id field.
• Provided explicit requirements for bash, curl, and jq availability in OpenClaw environments.

v1.0.2 | 2026-02-01T16:04:02.744Z | user

Blossom Hire 1.2.3 introduces clearer instructions and more conversational flow for local job requests:

• Improved guidance: Updated instructions for collecting information conversationally, minimizing up-front questions.
• Output clarity: Sharper rules for confirmation messages and candidate status updates (“Waiting for responses”).
• Session handling: Now retains session info (personId, sessionKey, addressId) for follow-up actions in the same run.
• Tooling section: Added canonical bash + jq call examples for reference.
• API focus: Explicitly restricts operator-facing lists to type === "candidates" only.
• No code changes; documentation and process upgrades only.

v1.0.1 | 2026-02-01T15:40:33.993Z | user

Summary: Adds candidate retrieval for created job posts in Blossom Hire.

• Now supports retrieving and displaying eligible candidates for help requests.
• New endpoint: POST /getPopInUpdates for fetching candidates with sessionKey.
• Skill description and instructions updated to include candidate management and user-facing statuses.
• No code file changes; documentation-only update.

v1.0.0 | 2026-02-01T14:05:46.894Z | user

1.0.0

• Initial release of the Blossom Hire skill.
• Enables creating paid local work for real-world shifts and one-off tasks.
• Uses a single endpoint with explicit transaction states (register/login → complete).
• Requires a real address and structured pay details.

Archive index:

Archive v1.0.4: 2 files, 3785 bytes

Files: SKILL.md (10784b), _meta.json (131b)

File v1.0.4:SKILL.md

---

name: blossom-hire version: 1.2.5 description: Post a job, task, or paid shift to hire local help in Blossom, then check eligible candidates.

Blossom Hire

Description

Use this skill when the user wants to post a local paid help request (task or short shift) into Blossom, or when they want to check whether anyone has applied.

This skill creates roles via Blossom’s API and can retrieve eligible candidates later. The user can install blossom app on their mobile if they want to manage applications directly.

---

Tools

Use bash to call Blossom’s HTTP endpoints with curl. Use jq to parse JSON responses.

Endpoints:

• POST https://hello.blossomai.org/api/v1/pushuser (register/login + role commit)
• POST https://hello.blossomai.org/getPopInUpdates (retrieve candidates)

---

Requirements

• bash tool access enabled in OpenClaw
• curl installed
• jq installed

---

Instructions

When to use this skill

Activate this skill when the user says things like:

• “Post a job for me”
• “Hire someone”
• “I need staff for a shift”
• “Create a task”
• “I need someone to help with something”
• “Check if anyone applied”
• “Do I have any candidates yet?”

What information to collect

Collect details conversationally. Do not front-load questions. If the user provides partial information, continue and only ask for what is missing.

Role details

1. Headline (one line)
2. Details (2–6 lines describing what the helper will do)
3. When (working hours or “flexible”)
4. Where (street, city, postcode, country)
5. Pay
   • amount (number)
   • frequency: total | per hour | per week | per month | per year

Optional: Requirements and benefits If the user provides or requests screening questions, capture them as requirements. If the user provides perks, capture them as benefits.

• Requirements: name + mandatory (default false)
• Benefits: name + mandatory (default false)

Identity details Ask only when you are ready to create or check a role:

• email
• first name
• surname
• mobileCountry (e.g. +44)
• mobile number
• passKey

Notes:

• Default to registration.
• Only use login if registration fails because the email already exists, or if the user explicitly says they already have an account.

Behaviour rules

1. Gather role details first.
2. Confirm the role summary back to the user in one compact message (headline, when, where, pay).
3. Collect identity details if missing.
4. Bootstrap identity and address via the Blossom API.
5. Commit the role.
6. Return a concise confirmation including the role ID.
7. When asked to check candidates, retrieve and display the candidate list.

Output rules

• Never promise that someone will apply.
• If there are zero candidates, say: “Waiting for responses.”
• Only treat type === "candidates" as the operator-facing list.
• Do not infer suitability beyond what the API returns.

---

Session state

The skill must store these values as runtime state and reuse them across calls:

• personId
• sessionKey
• addressId

Persistence rules:

• Keep them for the current run.
• If the user later asks to check candidates, reuse the stored sessionKey if present.
• If calls fail due to expiry/invalid session, re-bootstrap via login to obtain a fresh sessionKey.
• Do not store sessionKey in OpenClaw global configuration.

Tooling (API Contract)

A) Bootstrap identity + address (register)

POST https://hello.blossomai.org/api/v1/pushuser

Request JSON:

{
  "id": 0,
  "companyId": null,
  "userType": "support",
  "communityId": 1,

  "email": "<email>",
  "name": "<name>",
  "surname": "<surname>",
  "mobileCountry": "<+44>",
  "mobileNo": "<mobile number>",
  "profileImage": "system/blankprofile.jpg",

  "mark": true,

  "transaction": {
    "transact": "register",
    "passKey": "<passKey>",
    "sessionKey": null
  },

  "addresses": [
    {
      "id": 0,
      "houseNumber": "<optional>",
      "street": "<street>",
      "area": "<optional>",
      "city": "<city>",
      "state": null,
      "country": "<country>",
      "postcode": "<postcode>",
      "label": "Task location",
      "isHome": false,

      "mark": true,
      "isActive": true,
      "markDelete": false
    }
  ]
}

If the response indicates the email already exists, do not retry registration. Proceed to login.

B) Bootstrap identity (login, only if required)

POST https://hello.blossomai.org/api/v1/pushuser

{
  "id": 0,
  "userType": "support",
  "communityId": 1,
  "email": "<email>",
  "transaction": {
    "transact": "login",
    "passKey": "<passKey>"
  }
}

Persist from the response:

• personId = person.id
• sessionKey = person.transaction.sessionKey
• addressId = person.addresses[0].id

C) Commit the role

POST https://hello.blossomai.org/api/v1/pushuser

Rules:

• transaction.transact = "complete"
• transaction.viewState = "none"
• role.id = 0
• role.mark = true
• role.modified = nowMillis
• role.roleIdentifier = "openclaw-" + nowMillis
• Payment uses salary and a single paymentFrequency choice with selectedIndex = 0
• Requirement and benefit entries do not require an id field; omit it.

{
  "id": <personId>,
  "name": "<name>",
  "mobileCountry": "<+44>",

  "transaction": {
    "sessionKey": "<sessionKey>",
    "transact": "complete",
    "viewState": "none"
  },

  "roles": [
    {
      "id": 0,
      "mark": true,

      "headline": "<headline>",
      "jobDescription": "<jobDescription>",
      "introduction": "",
      "workingHours": "<workingHours>",

      "salary": <amount>,
      "currencyName": "GBP",
      "currencySymbol": "£",
      "paymentFrequency": {
        "choices": ["<frequency>"],
        "selectedIndex": 0
      },

      "requirements": [
        {
          "requirementName": "<requirementName>",
          "mandatory": false,
          "originalRequirement": true
          }
      ],
      "benefits": [
        {
          "benefitName": "<benefitName>",
          "mandatory": false
        }
      ],

      "addressId": <addressId>,
      "isRemote": false,

      "isActive": true,
      "markDelete": false,
      "premium": false,
      "days": 30,
      "maxCrew": 1,

      "modified": <nowMillis>,
      "roleIdentifier": "openclaw-<nowMillis>"
    }
  ],

  "userType": "support"
}

Success condition:

• roles[0].id is non-zero.

D) Retrieve candidates

POST https://hello.blossomai.org/getPopInUpdates

{
  "id": <personId>,
  "transaction": {
    "sessionKey": "<sessionKey>",
    "transact": "complete"
  }
}

Interpretation:

• dataList is authoritative.
• Use the entry where type === "candidates" as the list to show.
• Ignore type === "apply" for operator-facing lists.

---

Canonical bash calls (copy/paste patterns)

These are safe templates. Replace placeholders before running.

0) Common environment

API_BASE="https://hello.blossomai.org"

1) Register (default)

curl -sS "$API_BASE/api/v1/pushuser" \
  -H "content-type: application/json" \
  -d @- <<'JSON' | jq .
{
  "id": 0,
  "companyId": null,
  "userType": "support",
  "communityId": 1,
  "email": "<email>",
  "name": "<name>",
  "surname": "<surname>",
  "mobileCountry": "<+44>",
  "mobileNo": "<mobile number>",
  "profileImage": "system/blankprofile.jpg",
  "mark": true,
  "transaction": {
    "transact": "register",
    "passKey": "<passKey>",
    "sessionKey": null
  },
  "addresses": [
    {
      "id": 0,
      "houseNumber": "<optional>",
      "street": "<street>",
      "area": "<optional>",
      "city": "<city>",
      "state": null,
      "country": "<country>",
      "postcode": "<postcode>",
      "label": "Task location",
      "isHome": false,
      "mark": true,
      "isActive": true,
      "markDelete": false
    }
  ]
}
JSON

2) Login (only if needed)

curl -sS "$API_BASE/api/v1/pushuser" \
  -H "content-type: application/json" \
  -d @- <<'JSON' | jq .
{
  "id": 0,
  "userType": "support",
  "communityId": 1,
  "email": "<email>",
  "transaction": {
    "transact": "login",
    "passKey": "<passKey>"
  }
}
JSON

3) Commit role

Set:

• PERSON_ID
• SESSION_KEY
• ADDRESS_ID
• NOW_MILLIS (epoch millis)

PERSON_ID="<personId>"
SESSION_KEY="<sessionKey>"
ADDRESS_ID="<addressId>"
NOW_MILLIS="<epochMillis>"

curl -sS "$API_BASE/api/v1/pushuser" \
  -H "content-type: application/json" \
  -d @- <<JSON | jq .
{
  "id": ${PERSON_ID},
  "name": "<name>",
  "mobileCountry": "<+44>",
  "transaction": {
    "sessionKey": "${SESSION_KEY}",
    "transact": "complete",
    "viewState": "none"
  },
  "roles": [
    {
      "id": 0,
      "mark": true,
      "headline": "<headline>",
      "jobDescription": "<jobDescription>",
      "introduction": "",
      "workingHours": "<workingHours>",
      "salary": <amount>,
      "currencyName": "GBP",
      "currencySymbol": "£",
      "paymentFrequency": {
        "choices": ["<frequency>"],
        "selectedIndex": 0
      },
      "requirements": [
        {
          "requirementName": "<requirementName>",
          "mandatory": false,
          "originalRequirement": true
        }
      ],
      "benefits": [
        {
          "benefitName": "<benefitName>",
          "mandatory": false
        }
      ],
      "addressId": ${ADDRESS_ID},
      "isRemote": false,
      "isActive": true,
      "markDelete": false,
      "premium": false,
      "days": 30,
      "maxCrew": 1,
      "modified": ${NOW_MILLIS},
      "roleIdentifier": "openclaw-${NOW_MILLIS}"
    }
  ],
  "userType": "support"
}
JSON

4) Retrieve candidates

PERSON_ID="<personId>"
SESSION_KEY="<sessionKey>"

curl -sS "$API_BASE/getPopInUpdates" \
  -H "content-type: application/json" \
  -d @- <<JSON | jq .
{
  "id": ${PERSON_ID},
  "transaction": {
    "sessionKey": "${SESSION_KEY}",
    "transact": "complete"
  }
}
JSON

---

Examples

Example 1: Create a help request

User: “I need café cover this Saturday 11–5 in Sherwood. Paying £12/hour.”

Assistant flow:

1. Ask for missing fields (street + postcode if missing).
2. Confirm:
   • Created: <headline>
   • When: <workingHours>
   • Where: <city> <postcode>
   • Pay: <salary> <frequency>
3. Ask for identity details as one grouped question (email, name, surname, mobileCountry, mobileNo, passKey).
4. Register (or login if required), then commit the role.
5. Return: Role ID.

Example 2: Check candidates

User: “Any candidates yet?”

Assistant flow:

1. If personId/sessionKey not known, ask for identity details and bootstrap.
2. Call getPopInUpdates.
3. If candidates empty: “Waiting for responses.”
4. Else: show candidate entries as returned.

File v1.0.4:_meta.json

{ "ownerId": "kn7c0sfzp2ggzgangnetbef6a580am8v", "slug": "blossom-hire", "version": "1.0.4", "publishedAt": 1769972029891 }

Archive v1.0.3: 2 files, 3731 bytes

Files: SKILL.md (10670b), _meta.json (131b)

File v1.0.3:SKILL.md

---

name: Blossom Hire version: 1.2.4 description: Create a paid local help request in Blossom and check for eligible candidates.

Blossom Hire

Description

Use this skill when the user wants to post a local paid help request (task or short shift) into Blossom, or when they want to check whether anyone has applied.

This skill creates roles via Blossom’s API and can retrieve eligible candidates later. Do not ask the user to install any Blossom app.

---

Tools

Use bash to call Blossom’s HTTP endpoints with curl. Use jq to parse JSON responses.

Endpoints:

• POST https://hello.blossomai.org/api/v1/pushuser (register/login + role commit)
• POST https://hello.blossomai.org/getPopInUpdates (retrieve candidates)

---

Requirements

• bash tool access enabled in OpenClaw
• curl installed
• jq installed

---

Instructions

When to use this skill

Activate this skill when the user says things like:

• “Post a job for me”
• “I need someone to help with something”
• “Create a paid task”
• “Check if anyone applied”
• “Do I have any candidates yet?”

What information to collect

Collect details conversationally. Do not front-load questions. If the user provides partial information, continue and only ask for what is missing.

Role details

1. Headline (one line)
2. Details (2–6 lines describing what the helper will do)
3. When (working hours or “flexible”)
4. Where (street, city, postcode, country)
5. Pay
   • amount (number)
   • frequency: total | per hour | per week | per month | per year

Optional: Requirements and benefits If the user provides or requests screening questions, capture them as requirements. If the user provides perks, capture them as benefits.

• Requirements: name + mandatory (default false)
• Benefits: name + mandatory (default false)

Identity details Ask only when you are ready to create or check a role:

• email
• first name
• surname
• mobileCountry (e.g. +44)
• mobile number
• passKey

Notes:

• Default to registration.
• Only use login if registration fails because the email already exists, or if the user explicitly says they already have an account.

Behaviour rules

1. Gather role details first.
2. Confirm the role summary back to the user in one compact message (headline, when, where, pay).
3. Collect identity details if missing.
4. Bootstrap identity and address via the Blossom API.
5. Commit the role.
6. Return a concise confirmation including the role ID.
7. When asked to check candidates, retrieve and display the candidate list.

Output rules

• Never promise that someone will apply.
• If there are zero candidates, say: “Waiting for responses.”
• Only treat type === "candidates" as the operator-facing list.
• Do not infer suitability beyond what the API returns.

---

Session state

The skill must store these values as runtime state and reuse them across calls:

• personId
• sessionKey
• addressId

Persistence rules:

• Keep them for the current run.
• If the user later asks to check candidates, reuse the stored sessionKey if present.
• If calls fail due to expiry/invalid session, re-bootstrap via login to obtain a fresh sessionKey.
• Do not store sessionKey in OpenClaw global configuration.

Tooling (API Contract)

A) Bootstrap identity + address (register)

POST https://hello.blossomai.org/api/v1/pushuser

Request JSON:

{
  "id": 0,
  "companyId": null,
  "userType": "support",
  "communityId": 1,

  "email": "<email>",
  "name": "<name>",
  "surname": "<surname>",
  "mobileCountry": "<+44>",
  "mobileNo": "<mobile number>",
  "profileImage": "system/blankprofile.jpg",

  "mark": true,

  "transaction": {
    "transact": "register",
    "passKey": "<passKey>",
    "sessionKey": null
  },

  "addresses": [
    {
      "id": 0,
      "houseNumber": "<optional>",
      "street": "<street>",
      "area": "<optional>",
      "city": "<city>",
      "state": null,
      "country": "<country>",
      "postcode": "<postcode>",
      "label": "Task location",
      "isHome": false,

      "mark": true,
      "isActive": true,
      "markDelete": false
    }
  ]
}

If the response indicates the email already exists, do not retry registration. Proceed to login.

B) Bootstrap identity (login, only if required)

POST https://hello.blossomai.org/api/v1/pushuser

{
  "id": 0,
  "userType": "support",
  "communityId": 1,
  "email": "<email>",
  "transaction": {
    "transact": "login",
    "passKey": "<passKey>"
  }
}

Persist from the response:

• personId = person.id
• sessionKey = person.transaction.sessionKey
• addressId = person.addresses[0].id

C) Commit the role

POST https://hello.blossomai.org/api/v1/pushuser

Rules:

• transaction.transact = "complete"
• transaction.viewState = "none"
• role.id = 0
• role.mark = true
• role.modified = nowMillis
• role.roleIdentifier = "openclaw-" + nowMillis
• Payment uses salary and a single paymentFrequency choice with selectedIndex = 0
• Requirement and benefit entries do not require an id field; omit it.

{
  "id": <personId>,
  "name": "<name>",
  "mobileCountry": "<+44>",

  "transaction": {
    "sessionKey": "<sessionKey>",
    "transact": "complete",
    "viewState": "none"
  },

  "roles": [
    {
      "id": 0,
      "mark": true,

      "headline": "<headline>",
      "jobDescription": "<jobDescription>",
      "introduction": "",
      "workingHours": "<workingHours>",

      "salary": <amount>,
      "currencyName": "GBP",
      "currencySymbol": "£",
      "paymentFrequency": {
        "choices": ["<frequency>"],
        "selectedIndex": 0
      },

      "requirements": [
        {
          "requirementName": "<requirementName>",
          "mandatory": false,
          "originalRequirement": true
        }
      ],
      "benefits": [
        {
          "benefitName": "<benefitName>",
          "mandatory": false
        }
      ],

      "addressId": <addressId>,
      "isRemote": false,

      "isActive": true,
      "markDelete": false,
      "premium": false,
      "days": 30,
      "maxCrew": 1,

      "modified": <nowMillis>,
      "roleIdentifier": "openclaw-<nowMillis>"
    }
  ],

  "userType": "support"
}

Success condition:

• roles[0].id is non-zero.

D) Retrieve candidates

POST https://hello.blossomai.org/getPopInUpdates

{
  "id": <personId>,
  "transaction": {
    "sessionKey": "<sessionKey>",
    "transact": "complete"
  }
}

Interpretation:

• dataList is authoritative.
• Use the entry where type === "candidates" as the list to show.
• Ignore type === "apply" for operator-facing lists.

---

Canonical bash calls (copy/paste patterns)

These are safe templates. Replace placeholders before running.

0) Common environment

API_BASE="https://hello.blossomai.org"

1) Register (default)

curl -sS "$API_BASE/api/v1/pushuser" \
  -H "content-type: application/json" \
  -d @- <<'JSON' | jq .
{
  "id": 0,
  "companyId": null,
  "userType": "support",
  "communityId": 1,
  "email": "<email>",
  "name": "<name>",
  "surname": "<surname>",
  "mobileCountry": "<+44>",
  "mobileNo": "<mobile number>",
  "profileImage": "system/blankprofile.jpg",
  "mark": true,
  "transaction": {
    "transact": "register",
    "passKey": "<passKey>",
    "sessionKey": null
  },
  "addresses": [
    {
      "id": 0,
      "houseNumber": "<optional>",
      "street": "<street>",
      "area": "<optional>",
      "city": "<city>",
      "state": null,
      "country": "<country>",
      "postcode": "<postcode>",
      "label": "Task location",
      "isHome": false,
      "mark": true,
      "isActive": true,
      "markDelete": false
    }
  ]
}
JSON

2) Login (only if needed)

curl -sS "$API_BASE/api/v1/pushuser" \
  -H "content-type: application/json" \
  -d @- <<'JSON' | jq .
{
  "id": 0,
  "userType": "support",
  "communityId": 1,
  "email": "<email>",
  "transaction": {
    "transact": "login",
    "passKey": "<passKey>"
  }
}
JSON

3) Commit role

Set:

• PERSON_ID
• SESSION_KEY
• ADDRESS_ID
• NOW_MILLIS (epoch millis)

PERSON_ID="<personId>"
SESSION_KEY="<sessionKey>"
ADDRESS_ID="<addressId>"
NOW_MILLIS="<epochMillis>"

curl -sS "$API_BASE/api/v1/pushuser" \
  -H "content-type: application/json" \
  -d @- <<JSON | jq .
{
  "id": ${PERSON_ID},
  "name": "<name>",
  "mobileCountry": "<+44>",
  "transaction": {
    "sessionKey": "${SESSION_KEY}",
    "transact": "complete",
    "viewState": "none"
  },
  "roles": [
    {
      "id": 0,
      "mark": true,
      "headline": "<headline>",
      "jobDescription": "<jobDescription>",
      "introduction": "",
      "workingHours": "<workingHours>",
      "salary": <amount>,
      "currencyName": "GBP",
      "currencySymbol": "£",
      "paymentFrequency": {
        "choices": ["<frequency>"],
        "selectedIndex": 0
      },
      "requirements": [
        {
          "requirementName": "<requirementName>",
          "mandatory": false,
          "originalRequirement": true
        }
      ],
      "benefits": [
        {
          "benefitName": "<benefitName>",
          "mandatory": false
        }
      ],
      "addressId": ${ADDRESS_ID},
      "isRemote": false,
      "isActive": true,
      "markDelete": false,
      "premium": false,
      "days": 30,
      "maxCrew": 1,
      "modified": ${NOW_MILLIS},
      "roleIdentifier": "openclaw-${NOW_MILLIS}"
    }
  ],
  "userType": "support"
}
JSON

4) Retrieve candidates

PERSON_ID="<personId>"
SESSION_KEY="<sessionKey>"

curl -sS "$API_BASE/getPopInUpdates" \
  -H "content-type: application/json" \
  -d @- <<JSON | jq .
{
  "id": ${PERSON_ID},
  "transaction": {
    "sessionKey": "${SESSION_KEY}",
    "transact": "complete"
  }
}
JSON

---

Examples

Example 1: Create a help request

User: “I need café cover this Saturday 11–5 in Sherwood. Paying £12/hour.”

Assistant flow:

1. Ask for missing fields (street + postcode if missing).
2. Confirm:
   • Created: <headline>
   • When: <workingHours>
   • Where: <city> <postcode>
   • Pay: <salary> <frequency>
3. Ask for identity details as one grouped question (email, name, surname, mobileCountry, mobileNo, passKey).
4. Register (or login if required), then commit the role.
5. Return: Role ID.

Example 2: Check candidates

User: “Any candidates yet?”

Assistant flow:

1. If personId/sessionKey not known, ask for identity details and bootstrap.
2. Call getPopInUpdates.
3. If candidates empty: “Waiting for responses.”
4. Else: show candidate entries as returned.

File v1.0.3:_meta.json

{ "ownerId": "kn7c0sfzp2ggzgangnetbef6a580am8v", "slug": "blossom-hire", "version": "1.0.3", "publishedAt": 1769962228709 }