construct-ai-primary/agent-companies-paperclip/authentication-flows-devforge

Claude Code and agent skill by construct-ai-primary/agent-companies-paperclip

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

Use when authentication issues occur including OAuth to API key migration, session caching problems, CLI auth in authenticated deployment mode, or agent 401 errors. Handles Anthropic OAuth expiration, API key configuration, and auth token refresh.

Install

npx vskill@latest install construct-ai-primary/agent-companies-paperclip/authentication-flows-devforge

SKILL.md

The same SKILL.md was published earlier as construct-ai-primary/agent-companies-paperclip/authentication-flows-devforge.

Authentication Flows - DevForge AI

Overview

Handles authentication and authorization issues in the Paperclip codebase. Resolves OAuth-to-API-key migration issues, session caching problems, CLI authentication in authenticated deployment mode, and agent run 401 errors caused by stale auth tokens.

When to Use

  • When agents return 401 with "OAuth token has expired" after API key is configured
  • When CLI commands fail with "Unauthorized" in authenticated deployment mode
  • When session ID is reused across runs with stale OAuth tokens
  • When deploymentMode: "authenticated" breaks CLI heartbeat/agent-list commands
  • Don't use when: It's an API permissions issue (use gatekeeper-devforge-access-control)

Core Procedures

Auth Migration Workflow
  1. Identify Auth Method - Check config.json for llm.provider, llm.apiKey, OAuth settings
  2. Check Session Cache - Look for cached OAuth sessions in instance data
  3. Clear Stale Sessions - Remove cached auth sessions that reference expired tokens
  4. Verify API Key - Confirm API key is correctly set and valid via doctor check
  5. Test Agent Run - Trigger agent run and verify API key is used (not OAuth)
  6. CLI Auth Support - Add email/password or session token support for authenticated mode
Common Auth Issues
  • OAuth session cached in ~/.paperclip/instances/*/sessions/ — clear to force API key use
  • CLI has no auth credential passing in authenticated mode — needs --email/--password flags
  • Agent JWT secret not set — causes 401 on all agent runs

Agent Assignment

Primary Agent: devcore-devforge-core-development Company: DevForge AI Role: Authentication Specialist Reports To: devcore-devforge-core-development Backup Agents: gatekeeper-devforge-access-control, interface-devforge-api-integration

Success Metrics

  • API key auth works immediately after configuration
  • No OAuth session reuse after API key switch
  • CLI works in authenticated mode with proper credentials
  • Agent runs succeed with configured auth method

Error Handling

  • Error: API key invalid after config

Response: Validate key format, check provider, test with direct API call

  • Error: CLI auth credentials not available

Response: Add credential storage, env var support, or interactive prompt

Cross-Team Integration

Gigabrain Tags: devforge, authentication, oauth, api-key, session, cli-auth Related Skills: devcore-devforge-core-development, gatekeeper-devforge-access-control, interface-devforge-api-integration Last Updated: 2026-04-07

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
1
7-day trend score
8

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/construct-ai-primary/agent-companies-paperclip/authentication-flows-devforge/badge)](https://verified-skill.com/skills/construct-ai-primary/agent-companies-paperclip/authentication-flows-devforge)

Something wrong with this skill or its page? Tell us.