{"kind":"Skill","metadata":{"namespace":"community","name":"ashby-automation","version":"0.1.0"},"spec":{"description":"Automate recruiting and hiring workflows in Ashby -- manage candidates, jobs, applications, interviews, and notes through natural language commands.","files":{"SKILL.md":"---\nname: Ashby Automation\ndescription: \"Automate recruiting and hiring workflows in Ashby -- manage candidates, jobs, applications, interviews, and notes through natural language commands.\"\nrequires:\n  mcp:\n    - rube\n---\n\n# Ashby Automation\n\nAutomate your Ashby ATS recruiting operations directly from Claude Code. Create candidates, post jobs, manage applications, view interview schedules, and search your talent pipeline -- all without leaving your terminal.\n\n**Toolkit docs:** [composio.dev/toolkits/ashby](https://composio.dev/toolkits/ashby)\n\n---\n\n## Setup\n\n1. Add the Rube MCP server to your Claude Code config with URL: `https://rube.app/mcp`\n2. When prompted, authenticate your Ashby account through the connection link provided\n3. Start automating your recruiting workflows with natural language\n\n---\n\n## Core Workflows\n\n### 1. Manage Candidates\n\nCreate, list, search, update, and retrieve detailed candidate information.\n\n**Tools:** `ASHBY_CREATE_CANDIDATE`, `ASHBY_LIST_CANDIDATES`, `ASHBY_SEARCH_CANDIDATES`, `ASHBY_GET_CANDIDATE_INFO`, `ASHBY_UPDATE_CANDIDATE`\n\n```\nCreate a candidate named \"Jane Smith\" with email jane@example.com and LinkedIn profile https://linkedin.com/in/janesmith\n```\n\nKey parameters for `ASHBY_CREATE_CANDIDATE`:\n- `name` (required) -- full name of the candidate\n- `email` -- primary email address\n- `phoneNumber`, `linkedInUrl`, `githubUrl`, `websiteUrl` -- contact/social profiles\n\nKey parameters for `ASHBY_SEARCH_CANDIDATES`:\n- `email` -- exact email match\n- `name` -- partial name match\n\nKey parameters for `ASHBY_LIST_CANDIDATES`:\n- `perPage` (max 100) / `cursor` -- pagination\n- `syncToken` -- for incremental updates since last sync\n\n### 2. Create and List Jobs\n\nPost new job openings and browse existing positions.\n\n**Tools:** `ASHBY_CREATE_JOB`, `ASHBY_LIST_JOBS`, `ASHBY_GET_JOB_INFO`\n\n```\nCreate a new \"Senior Software Engineer\" job in team dept-123 at location loc-456 with brand brand-789\n```\n\nKey parameters for `ASHBY_CREATE_JOB`:\n- `title` (required) -- job title\n- `teamId` (required) -- department/team ID (from list departments)\n- `locationId` (required) -- office location ID (from list locations)\n- `brandId` (required) -- employer brand ID (from list brands)\n- `defaultInterviewPlanId` -- required to open the job for applications\n- `jobTemplateId` -- pre-populate from a template\n\nKey parameters for `ASHBY_LIST_JOBS`:\n- `perPage` (max 100) / `cursor` / `syncToken` -- pagination and incremental sync\n\n**Note:** Newly created jobs start in \"Draft\" status. You must set a `defaultInterviewPlanId` to open/publish the job.\n\n### 3. Manage Applications\n\nCreate applications to connect candidates to jobs and track their progress.\n\n**Tools:** `ASHBY_CREATE_APPLICATION`, `ASHBY_LIST_APPLICATIONS`\n\n```\nApply candidate cand-abc123 to job job-xyz789 with source src-referral\n```\n\nKey parameters for `ASHBY_CREATE_APPLICATION`:\n- `candidateId` (required) -- UUID of an existing candidate\n- `jobId` (required) -- UUID of an existing job\n- `sourceId` -- UUID of the application source (LinkedIn, Referral, etc.)\n- `creditedToUserId` -- UUID of recruiter/referrer to credit\n- `interviewStageId` -- place directly into a specific stage (defaults to first stage)\n\nKey parameters for `ASHBY_LIST_APPLICATIONS`:\n- `perPage` (max 100) / `cursor` / `syncToken` -- pagination and incremental sync\n\n### 4. View Interview Schedules\n\nList scheduled interviews with timing, interviewer, and candidate details.\n\n**Tool:** `ASHBY_LIST_INTERVIEW_SCHEDULES`\n\n```\nShow me all upcoming interview schedules\n```\n\nKey parameters:\n- `perPage` (max 100) / `cursor` -- pagination\n- `syncToken` -- incremental sync for changed schedules\n\n### 5. Candidate Notes\n\nView internal notes, observations, and recruiter comments on candidates.\n\n**Tool:** `ASHBY_LIST_CANDIDATE_NOTES`\n\n```\nShow me all notes for candidate cand-abc123\n```\n\n- Retrieves all notes added by recruiters and hiring team members\n- Useful for reviewing interview feedback and internal assessments\n\n### 6. Pipeline Reporting\n\nCombine listing tools to build hiring pipeline reports.\n\n**Tools:** `ASHBY_LIST_CANDIDATES`, `ASHBY_LIST_APPLICATIONS`, `ASHBY_LIST_JOBS`\n\n```\nList all applications to see the current state of our hiring pipeline\n```\n\n- Use `syncToken` for incremental data fetches (efficient for recurring reports)\n- Combine candidate, application, and job data for full pipeline visibility\n- Paginate through all results with `cursor` for complete datasets\n\n---\n\n## Known Pitfalls\n\n- **Jobs start in Draft:** Newly created jobs via `ASHBY_CREATE_JOB` start in \"Draft\" status and cannot accept applications until a `defaultInterviewPlanId` is set and the job is opened.\n- **Four required fields for jobs:** `ASHBY_CREATE_JOB` requires `title`, `teamId`, `locationId`, and `brandId`. Use list departments, locations, and brands endpoints to discover valid IDs.\n- **Candidate before application:** A candidate must exist before creating an application. Always create or find the candidate first, then create the application.\n- **Cursor-based pagination:** All list endpoints use cursor-based pagination with `perPage` (max 100) and `cursor`. You cannot jump to arbitrary pages -- you must iterate sequentially.\n- **`syncToken` for efficiency:** Use `syncToken` from previous responses to fetch only changed records. This dramatically reduces API calls for recurring workflows.\n- **UUID format everywhere:** All IDs (candidates, jobs, applications, stages) are UUIDs. Passing malformed IDs returns 400 errors.\n- **Search limitations:** `ASHBY_SEARCH_CANDIDATES` supports exact email match or partial name match, but not combined queries or other fields. For broader searches, use `ASHBY_LIST_CANDIDATES` with pagination.\n\n---\n\n## Quick Reference\n\n| Tool Slug | Description |\n|---|---|\n| `ASHBY_CREATE_CANDIDATE` | Create a new candidate (requires `name`) |\n| `ASHBY_LIST_CANDIDATES` | List all candidates with pagination and sync |\n| `ASHBY_SEARCH_CANDIDATES` | Search candidates by email or name |\n| `ASHBY_GET_CANDIDATE_INFO` | Get full candidate details (requires `candidateId`) |\n| `ASHBY_UPDATE_CANDIDATE` | Update candidate profile information |\n| `ASHBY_LIST_CANDIDATE_NOTES` | List internal notes for a candidate |\n| `ASHBY_CREATE_JOB` | Create a job opening (requires `title`, `teamId`, `locationId`, `brandId`) |\n| `ASHBY_LIST_JOBS` | List all jobs with pagination and sync |\n| `ASHBY_GET_JOB_INFO` | Get full job details by ID |\n| `ASHBY_CREATE_APPLICATION` | Apply a candidate to a job (requires `candidateId`, `jobId`) |\n| `ASHBY_LIST_APPLICATIONS` | List all applications with pagination and sync |\n| `ASHBY_LIST_INTERVIEW_SCHEDULES` | List scheduled interviews with pagination |\n\n---\n\n*Powered by [Composio](https://composio.dev)*\n"},"import":{"commit_sha":"f2b5e29bc315f04c8e09591ba275f4c4f7d4b8fe","imported_at":"2026-05-18T20:07:47Z","license_text":"","owner":"ComposioHQ","repo":"ComposioHQ/awesome-claude-skills","source_url":"https://github.com/ComposioHQ/awesome-claude-skills/tree/f2b5e29bc315f04c8e09591ba275f4c4f7d4b8fe/composio-skills/ashby-automation"}},"content_hash":[173,47,45,14,134,123,71,238,55,47,78,215,13,213,22,113,171,71,246,149,88,178,99,214,66,182,100,15,24,177,106,101],"trust_level":"unsigned","yanked":false}