substackctl 用于在命令行管理 Substack 自己出版物的文章，并阅读他人 newsletter。需 substackctl 0.1.0 或更高版本，该技能为手动安装且不与包版本锁定。
用途：读取公开内容（feed scan、feed crawl、feed crawl-all）；查看配置（profile list、profile check <name>）；创建草稿（post create <file>，可加 --dry-run 预览）；调整草稿（post update、section set、post unschedule）；删除草稿与已排期文章（post delete <id> --yes）。发布（post publish）、删除已发布文章、增删栏目、排期发送邮件等需先取得人工确认。
配置：一个 profile 对应名称、出版物 URL 和一个 cookie。相关命令：profile add <name> <publication>、profile check <name>、profile list / use / remove / login。cookie 约一两周过期，退出码 3 表示需用 login 刷新。作者类命令须显式传 --profile。
退出码：0 成功；1 一般失败；2 用法错误；3 认证失败；4 限流。机器可读输出优先用 --json，仅解析 stdout，进度与错误走 stderr。
文章文件为带 YAML 风格 front matter 的 Markdown，含 title（必填）及 subtitle、section、cover、audience、slug。post create 与 post schedule 应用全部字段，post publish 仅应用 title、subtitle、audience 并对丢弃的 slug、section、cover 发出警告。cover 只接受托管 http(s) URL；正文中的本地图片路径会被上传并重写为托管 URL，缺图会中止命令。爬取文件带 author、date、source_url、publication 等额外键会被忽略。
限制：发布不可撤回且可能给订阅者发邮件；删除已发布文章对所有订阅者生效；section remove 不可撤销。受众、时间或内容不确定时应先询问。