pal-e-docs

Skill: Board Add

skill-board-add Skill

active skill
Project

Skill: Board Add

Add a Forgejo issue or manual item to a project board. For issues that aren't auto-synced, or for ad-hoc work items.

When to Use

When you need to manually track something on a board that isn't auto-synced (ad-hoc TODOs, repo items, or issues from repos not yet linked to a board). Note: most issues auto-sync via sync-issues — only use this for items that don't appear after sync.

Arguments

Pass the Forgejo issue URL or a description as the argument: /board-add https://forgejo.../issues/123

Steps

  • Identify the board: Determine which project board this item belongs to. Board slug is board-{project-slug}.
  • Check if already on board: list_board_items(board_slug) — search for existing item to avoid duplicates.
  • Create board item: 
    create_board_item(
    board_slug="board-{project}",
    item_type="issue",  # or "todo", "repo"
    title="{repo} #{number}: {title}",
    column="backlog",  # default landing column
    forgejo_issue_url="https://forgejo.../issues/123"  # if issue
)
  • Confirm: Report the created item and its board position.

Title Convention

For Forgejo issues: {repo-name} #{number}: {title}. Example: claude-custom #20: SessionStart curl optimization.

MCP Tools Used

  • mcp__pal-e-docs__list_board_items
  • mcp__pal-e-docs__create_board_item
  • sop-board-workflow — item lifecycle and column semantics
  • skill-board-sync — for bulk reconciliation (preferred over manual adds)