Skip to content

Repository files navigation

SuperScript to Brackets Converter

Convert Google Docs footnotes and superscripts to properly spaced bracketed format: word [1], word [2], word [3]

💡 Need Help with Setup? Ask Claude to guide you through the Google API setup process step-by-step. Claude can help you create the Google Cloud project, enable APIs, and configure credentials.

Quick Start

Original: "Advanced AI models¹ continue to evolve² rapidly³"
Result:   "Advanced AI models [1] continue to evolve [2] rapidly [3]"

What You'll Need

⚠️ Setup Required: This tool needs Google Cloud API access (free tier works fine)

  • Google Cloud account (free)
  • 10 minutes for initial setup
  • Claude can walk you through each step - just ask!

Installation

  1. Clone this skill:

    git clone https://github.com/bengusuozcan/superscripttobrackets.git ~/.claude/skills/superscripttobrackets
  2. Install dependencies:

    pip install google-api-python-client google-auth-httplib2 google-auth-oauthlib
  3. Get Google API credentials (ask Claude: "Help me set up Google Docs API for the superscripttobrackets skill")

Usage

python3 superscripttobrackets.py /path/to/credentials.json YOUR_DOCUMENT_ID

Get document ID: Copy from Google Docs URL between /d/ and /edit

Features

Perfect spacing: word [1] not word[1]Sequential numbering: Maintains document order ✅ Multiple formats: Google Docs footnotes + manual superscripts ✅ Large documents: No context window limitations ✅ Safe processing: Preserves all formatting

Need Help?

Ask Claude for assistance with:

  • "Set up Google Cloud project for this skill"
  • "Help me get API credentials"
  • "Share my Google Doc with service account"
  • "Troubleshoot permission errors"
  • "Extract document ID from URL"

Common Setup Steps (Claude can guide you):

  1. Create Google Cloud project
  2. Enable Google Docs API
  3. Create service account
  4. Download JSON credentials
  5. Share your document with service account email

Error Handling

✅ Clear error messages for missing credentials, invalid IDs, and permission issues ✅ Automatic retry for API rate limits ✅ Helpful troubleshooting guidance


Created with Claude Code | MIT License | Ask Claude for setup help anytime!

About

Convert Google Docs footnotes and superscripts to bracketed format with proper spacing. A Claude Code skill for systematic footnote conversion.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages