dirs-submit
CLI tool for the `ship` command wrapping aidirs.org and backlinkdirs.com submission APIs. Use when the user needs to login, submit a URL, preview site metadata, check CLI version, or self-update the CLI from terminal. Supports browser login, per-site token storage, submit/fetch commands, version checks, and self-update.
Best use case
dirs-submit is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
CLI tool for the `ship` command wrapping aidirs.org and backlinkdirs.com submission APIs. Use when the user needs to login, submit a URL, preview site metadata, check CLI version, or self-update the CLI from terminal. Supports browser login, per-site token storage, submit/fetch commands, version checks, and self-update.
Teams using dirs-submit should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/dirs-submit/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How dirs-submit Compares
| Feature / Agent | dirs-submit | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
CLI tool for the `ship` command wrapping aidirs.org and backlinkdirs.com submission APIs. Use when the user needs to login, submit a URL, preview site metadata, check CLI version, or self-update the CLI from terminal. Supports browser login, per-site token storage, submit/fetch commands, version checks, and self-update.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
AI Agents for Coding
Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.
Best AI Skills for Claude
Explore the best AI skills for Claude and Claude Code across coding, research, workflow automation, documentation, and agent operations.
Cursor vs Codex for AI Workflows
Compare Cursor and Codex for AI coding workflows, repository assistance, debugging, refactoring, and reusable developer skills.
SKILL.md Source
# dirs-submit
Use `ship` to login, submit URLs, preview metadata, check versions, and self-update.
## Structure
- Read `references/config.md` when you need config shape or token storage details.
- Read `references/api.md` when you need request endpoints or payload examples.
- Read files under `examples/` when you need concrete success/error output examples.
## Workflow
### 1. Login — 浏览器授权
> 提交 URL 需要订阅计划。
```bash
ship login
```
可选指定站点：
```bash
ship login --site aidirs.org
ship login --site backlinkdirs.com
```
流程：
1. 选择站点（或通过 `--site` 指定）
2. 自动打开浏览器进入登录页
3. 用户在浏览器完成登录
4. CLI 在本地启动 localhost 回调接收 token
5. token 写入本地配置
成功输出：
```text
✅ Login successful
```
### 2. Token / Config 存储规则
配置文件路径：
```text
~/.config/ship/config.json
```
结构是**按站点分开存**：
```json
{
"currentSite": "aidirs.org",
"sites": {
"aidirs.org": {
"token": "xxx",
"baseUrl": "https://aidirs.org"
},
"backlinkdirs.com": {
"token": "yyy",
"baseUrl": "https://backlinkdirs.com"
}
}
}
```
规则：
- 同一个站点再次登录，会覆盖该站点旧 token
- 不同站点互不覆盖
- `currentSite` 指向最后一次登录的站点
- 不传 `--site` 时，CLI 默认使用 `currentSite`
### 3. Submit — 提交 URL
```bash
ship submit <url>
```
示例：
```bash
ship submit https://example.com
ship submit https://example.com --site aidirs.org
ship submit https://example.com --site backlinkdirs.com
ship submit https://example.com --json
ship submit https://example.com --quiet
```
内部调用：
```http
POST /api/submit
Authorization: Bearer <token>
Content-Type: application/json
{ "link": "https://example.com" }
```
### 4. Fetch — 预览元数据
```bash
ship fetch <url>
```
示例：
```bash
ship fetch https://example.com
ship fetch https://example.com --site aidirs.org
ship fetch https://example.com --json
```
调用 `POST /api/fetch-website`，不创建提交记录。
### 5. Version / Update
```bash
ship version
ship version --latest
ship version --json
ship self-update
ship self-update --json
```
说明：
- `version --latest` 会检查 GitHub latest release
- `self-update` 会下载当前平台对应的 release asset 并替换本地可执行文件
- Windows 当前不做自动覆盖更新，会提示用户手动下载最新版本
## Result Interpretation
Skill 执行 CLI 后，应根据输出向用户自然语言转述：
- 成功提交 / 成功 fetch → 直接告知成功
- `401` → 告知 token 无效，建议重新运行 `ship login`
- `402` 或返回 `upgradeUrl` → 告知用户需要订阅，并附升级链接
- `400` → 直接转述具体错误
- 网络超时 / 网络错误 → 告知稍后重试
## 常见错误
| 状态码/情况 | 含义 | Skill 应告知用户 |
|---|---|---|
| 400 | URL 参数错误、重复站点等 | 直接告知具体错误原因 |
| 401 | Token 无效或未授权 | 提示重新运行 `ship login` |
| 402 | 需要订阅计划 | 友好提示订阅，并附 `upgradeUrl` |
| 500 | 服务器错误 | 告知稍后重试 |
| timeout/network | 网络超时或请求失败 | 告知网络问题并建议重试 |
## Environment / Config Reference
| 来源 | 键 | 说明 |
|---|---|---|
| 配置文件 | `~/.config/ship/config.json` | 本地存储多站点 token |
| 环境变量 | `DIRS_TOKEN` | Bearer Token（备用） |
| 环境变量 | `DIRS_BASE_URL` | API Base URL（备用） |
| CLI 参数 | `--site` | 显式切换站点 |
环境变量仍兼容，但优先推荐使用 `ship login` 写入配置。
## Examples
```bash
ship login --site aidirs.org
ship submit https://example.com --site aidirs.org
ship fetch https://example.com --site backlinkdirs.com --json
ship version --latest
ship self-update
```Related Skills
openmath-submit-theorem
Submits proofs to the OpenMath platform using a two-stage commit-reveal flow. Use when the user wants to commit a proof hash or reveal a Lean/Rocq proof on the Shentu network.
submit-work
Submit completed work for a task on OpenAnt. Submission = text description + files. IMPORTANT — before submitting, always check if your work produced any files and upload them first. Use when the agent has finished work and wants to deliver results, submit a solution, turn in deliverables, upload files, or send proof of completion. Covers "submit work", "deliver results", "I'm done", "here's my work", "submit solution", "upload and submit", "attach proof", "deliver file", "send deliverable".
---
name: article-factory-wechat
humanizer
Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases.
find-skills
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
tavily-search
Use Tavily API for real-time web search and content extraction. Use when: user needs real-time web search results, research, or current information from the web. Requires Tavily API key.
baidu-search
Search the web using Baidu AI Search Engine (BDSE). Use for live information, documentation, or research topics.
agent-autonomy-kit
Stop waiting for prompts. Keep working.
Meeting Prep
Never walk into a meeting unprepared again. Your agent researches all attendees before calendar events—pulling LinkedIn profiles, recent company news, mutual connections, and conversation starters. Generates a briefing doc with talking points, icebreakers, and context so you show up informed and confident. Triggered automatically before meetings or on-demand. Configure research depth, advance timing, and output format. Walking into meetings blind is amateur hour—missed connections, generic small talk, zero leverage. Use when setting up meeting intelligence, researching specific attendees, generating pre-meeting briefs, or automating your prep workflow.
self-improvement
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Claude ('No, that's wrong...', 'Actually...'), (3) User requests a capability that doesn't exist, (4) An external API or tool fails, (5) Claude realizes its knowledge is outdated or incorrect, (6) A better approach is discovered for a recurring task. Also review learnings before major tasks.
botlearn-healthcheck
botlearn-healthcheck — BotLearn autonomous health inspector for OpenClaw instances across 5 domains (hardware, config, security, skills, autonomy); triggers on system check, health report, diagnostics, or scheduled heartbeat inspection.
linkedin-cli
A bird-like LinkedIn CLI for searching profiles, checking messages, and summarizing your feed using session cookies.