← All playbooks · Raw API

task-authors-import

# Capability: Authors (person entries)

## Intent phrases

- create authors
- import people from spreadsheet
- add team members to CMS

## Requires capabilities

`persons`

## Prerequisites

- `cms_edit ["index", "sync"]` if linking to articles
- Convert spreadsheet to a structured list (name, slug, jobTitle, bio, email)

## Steps

**Batch import (recommended):**

1. Build `authors.json` with a `persons` array (see `cms-edit help person-from-json`)
2. `cms_edit ["create", "person-from-json", "--json", "<authors-json>", "--dry-run"]`
3. User confirms the list
4. `cms_edit ["create", "person-from-json", "--json", "<authors-json>", "--if-not-exists"]`

**Single person:**

```bash
cms_edit ["create", "person", "--slug", "<slug>", "--name", "<name>", "--job-title", "…", "--bio-markdown", "…"]
```

**Link to articles:**

```
cms_edit ["open", "--article-slug", "<slug>"]
cms_edit ["set", "@p0", "authors", "<personId1>,<personId2>", "--links"]
cms_edit ["diff"] → cms_edit ["save"]
```

## Confirmation gates

1. Show person list from spreadsheet — user confirms
2. `diff` before `save` when using sessions

## Out of scope

- Publish

## Related resources

- `cms-edit://customer/routing` (people URL base if configured)
- `cms-edit help person-from-json`