Start with one real question and leave with a next step.
Start with the question in front of you, then use the guide to make the next decision easier.
Try saying
“I am trying to make this decision. What should I look at first?”
Start with context
Bring the smallest useful example.
Look for the signal
Separate what is known from what is assumed.
Take one step
Choose an action you can review.
Shortcut Integration
What this connection is for
Bring Shortcut stories and delivery context into Specky, then create or update stories from approved work.
How your data reaches Specky
Specky pulls from Shortcut on a schedule. A sync runs when you open your workspace if the data is stale, and you can also start one by hand from the integration card.
Before you start
- API Token (Required) — Create one at Shortcut → Settings → Account → API Tokens.
- Default Project ID (optional) (Optional) — Stories are created in this project. Leave blank to use the first accessible project.
Setup
Open Settings → Integrations, find Shortcut, and click Connect. The form will tell you what to paste and where to find it.
Create an API token
- Open Shortcut API Tokens.
- Create a token and copy it once.
- In Specky, open Settings → Integrations → Shortcut and paste the token.
Data synced
| Data | Used for |
|---|---|
| Stories, descriptions, type, estimate, labels, and workflow state | Delivery context and prioritization |
| Groups and project links | Ownership and roadmap context |
Specky imports accessible Shortcut stories and can create or update stories from the Tickets view and Execution Bridge. It uses the configured project, or the first accessible project when none is supplied; workflow-state movement remains in Shortcut.
After connecting
New Shortcut items appear in Discovery alongside your other sources. You can search them, ask questions about them, and cite them in product work without opening another tab.
Disconnecting Shortcut removes the connection and the signals it brought in.
Troubleshooting
- Connected, but nothing appears. Open the Shortcut card and run a sync by hand. If it errors, the card shows the reason.
- "Upgrade to connect". Your plan caps how many integrations you can connect at once, and a few providers are Scale-only. Settings → Usage shows where you stand.
- Credentials stopped working. Tokens expire and get revoked. Reconnect with a fresh one — your existing signals are kept.
See the Shortcut integration page for what it's for and the questions people usually ask first, or the Integrations Overview for how integrations work in general.
Ready to apply this?
Start with your own product and keep the first read grounded. You'll create an account before the guided result so it can be saved to your workspace.