feat(typefully): add Substack Notes platform support - #31
Merged
Conversation
Typefully shipped Substack Notes (July 27); this adds it to the agent skill and CLI (TYP-7359): - Add substack to POST_PLATFORM_ORDER so it works with --platform, --all, platform auto-selection, and drafts:update platform resolution - Fail fast when thread content (--- separators or --append) targets substack: the API allows a single post per note, and its 422 is less actionable than a CLI-side error - Document the platform in SKILL.md (single-post constraint, 10,000 character limit, images/GIFs only with no video), README, CLAUDE.md, marketplace.json, and the skill changelog Constraints verified against the live API v2 and the backend implementation (SubstackPlatform schema, SUBSTACK_CONFIG media limits, SUBSTACK_NOTE_MAX_CHARS).
…ide-link-preview Backend PR typefully-backend#1802 adds Substack Notes to API v2's link-preview platforms: API-created notes with a URL now publish with a rich link card (skipped when the note has images), and the API accepts hide_link_preview on the substack post. - Add substack to HIDE_LINK_PREVIEW_PLATFORMS so --hide-link-preview applies to Substack Notes alongside LinkedIn and Threads (matching the editor's per-note hide control). - Update SKILL.md link-preview docs and the flags table; add a CHANGELOG entry. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Contributor
Author
|
Pushed a follow-up commit covering Substack Notes link previews: typefully/typefully-backend#1802 adds 🤖 Generated with Claude Code |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds Substack Notes (shipped in Typefully on July 27) to the agent skill and CLI. Closes TYP-7359.
substackjoinsPOST_PLATFORM_ORDER, so it works with--platform substack, is included in--alland platform auto-selection when connected, and resolves correctly ondrafts:update.---separators or--append) targetingsubstacknow fails fast with a clear error instead of surfacing the API's generic 422 (List should have at most 1 item...).--allinteracts with thread content. Platform lists updated in README, CLAUDE.md, marketplace.json, andx-articles.md; dated changelog entry added.--allinclusion, thread rejection on create,--appendrejection on update.Why
Agents using the skill had no way to target Substack Notes, and without the fail-fast check they'd hit an unhelpful 422 when drafting threads to it.
Reviewer notes
SubstackPlatformschema (max_items=1, plainPostwithextra=forbid),SUBSTACK_CONFIGmedia limits (image=6, video=0, gif=6), andSUBSTACK_NOTE_MAX_CHARS = 10_000(enforced at publish time only — hence documenting it so agents draft within it).LINK_PREVIEW_PLATFORMSexcludes it), so the existing link-preview docs are unchanged; a possible backend follow-up for that is tracked separately.