Skill: krishnakumarmahadevan-cmd/toolweb-technical-writer (version 1.0.0)

--- name: Technical Writer / Documentation Specialist Roadmap description: Professional career development platform that generates personalized technical writing roadmaps based on skills assessment and career goals. --- # Overview The Technical Writer / Documentation Specialist Roadmap API is a professional development platform designed to help aspiring and experienced technical writers chart their career path. This API enables users to receive AI-powered, personalized roadmaps tailored to their current experience level, skill set, tool proficiency, career goals, and target industry. The platform provides comprehensive career guidance by analyzing user assessments across multiple dimensions including technical skills, documentation tools, writing experience, and professional objectives. Whether you're transitioning into technical writing, specializing in a particular domain, or advancing your career, this API delivers structured learning paths and specialization recommendations. Ideal users include career changers entering technical writing, junior writers seeking structured advancement, organizations developing technical documentation teams, and professionals pursuing specialization in API documentation, security writing, or other technical domains. ## Usage **Generate a Personalized Roadmap:** ```json POST /api/technical-writer/roadmap { "assessmentData": { "experience": { "yearsInTech": 3, "documentationExperience": 1.5, "previousRoles": ["Software Engineer", "Support Specialist"] }, "skills": { "writing": "intermediate", "technicalKnowledge": "advanced", "editing": "beginner", "researching": "intermediate" }, "tools": { "markdown": true, "confluence": true, "jira": true, "git": true, "swagger": false }, "goals": { "primary": "API Documentation Specialist", "timeline": "12 months", "targetRole": "Senior Technical Writer" }, "industry": { "current": "SaaS", "target": "Security / Cloud" }, "sessionId": "sess_abc123def456", "timestamp": "2024-01-15T10:30:00Z" }, "sessionId": "sess_abc123def456", "userId": 12345, "timestamp": "2024-01-15T10:30:00Z" } ``` **Sample Response:** ```json { "roadmapId": "roadmap_xyz789", "userId": 12345, "sessionId": "sess_abc123def456", "generatedAt": "2024-01-15T10:30:15Z", "specialization": "API Documentation Specialist", "timeline": "12 months", "phases": [ { "phase": 1, "duration": "Months 1-3", "title": "Foundation & Tools Mastery", "objectives": [ "Master OpenAPI/Swagger documentation", "Learn advanced Markdown and reStructuredText", "Complete technical writing fundamentals course" ], "resources": [ "OpenAPI 3.0 Specification Guide", "Write the Docs API Documentation Course", "Swagger Editor Tutorials" ] }, { "phase": 2, "duration": "Months 4-6", "title": "Specialization Deep Dive", "objectives": [ "Create sample API documentation", "Learn developer experience best practices", "Study security documentation standards" ], "resources": [ "API Documentation Best Practices", "DevRel Fundamentals Course", "Security Writing Standards" ] }, { "phase": 3, "duration": "Months 7-12", "title": "Portfolio & Professional Growth", "objectives": [ "Build comprehensive API documentation portfolio", "Contribute to open-source projects", "Network and mentor junior writers" ], "resources": [ "GitHub documentation projects", "Technical Writing Communities", "Conference Speaking Opportunities" ] } ], "skillGaps": [ { "skill": "API Documentation", "currentLevel": "beginner", "targetLevel": "expert", "priority": "high" }, { "skill": "Information Architecture", "currentLevel": "intermediate", "targetLevel": "advanced", "priority": "high" } ], "recommendedSpecializations": [ "API Documentation", "Security Documentation", "DevOps/Cloud Documentation" ], "nextSteps": [ "Enroll in OpenAPI documentation course", "Set up local development environment", "Join Write the Docs community" ] } ``` ## Endpoints ### Root / Health Check **GET** `/` Health check endpoint to verify API availability. **Parameters:** None **Response:** ``` 200 OK - Returns confirmation of API health status ``` --- ### Generate Roadmap **POST** `/api/technical-writer/roadmap` Generates a personalized technical writing career roadmap based on user assessment data, experience, skills, tools, and career goals. **Parameters:** | Name | Type | Required | Description | |------|------|----------|-------------| | `assessmentData` | AssessmentData | Yes | Comprehensive assessment object containing experience, skills, tools, goals, and industry information | | `assessmentData.experience` | Object | Yes | User's professional experience details (years in tech, documentation experience, previous roles) | | `assessmentData.skills` | Object | Yes | Current skill levels (writing, technical knowledge, editing, research) | | `assessmentData.tools` | Object | Yes | Proficiency with documentation tools (Markdown, Confluence, Swagger, Git, etc.) | | `assessmentData.goals` | Object | Yes | Career objectives and target roles | | `assessmentData.industry` | Object | Yes | Current and target industry sectors | | `assessmentData.sessionId` | String | Yes | Unique session identifier | | `assessmentData.timestamp` | String | Yes | Assessment timestamp (ISO 8601 format) | | `sessionId` | String | Yes | Session identifier for tracking | | `userId` | Integer or null | Optional | Unique user identifier | | `timestamp` | String | Yes | Request timestamp (ISO 8601 format) | **Response:** ``` 200 OK - Returns personalized roadmap with phases, skill gaps, specializations, and next steps 422 Unprocessable Entity - Returns validation error details if request is invalid ``` --- ### Get Specializations **GET** [REDACTED_SECRET] Retrieves all available technical writing specialization paths and career tracks. **Parameters:** None **Response:** ``` 200 OK - Returns array of available specializations including: - API Documentation - Security Documentation - DevOps/Cloud Documentation - User Experience Writing - Technical Marketing Writing - Knowledge Base Administration ``` --- ### Get Learning Paths **GET** [REDACTED_SECRET] Retrieves all available structured learning paths for technical writing career development. **Parameters:** None **Response:** ``` 200 OK - Returns array of learning paths with: - Path title and description - Duration and difficulty level - Prerequisites - Learning resources - Certification opportunities ``` ## Pricing | Plan | Calls/Day | Calls/Month | Price | |------|-----------|-------------|-------| | Free | 5 | 50 | Free | | Developer | 20 | 500 | $39/mo | | Professional | 200 | 5,000 | $99/mo | | Enterprise | 100,000 | 1,000,000 | $299/mo | ## About ToolWeb.in - 200+ security APIs, CISSP & CISM, platforms: Pay-per-run, API Gateway, MCP Server, OpenClaw, RapidAPI, YouTube. - [toolweb.in](https://toolweb.in) - [portal.toolweb.in](https://portal.toolweb.in) - [hub.toolweb.in](https://hub.toolweb.in) - [toolweb.in/openclaw/](https://toolweb.in/openclaw/) - [rapidapi.com/user/mkrishna477](https://rapidapi.com/user/mkrishna477) - [youtube.com/@toolweb-009](https://youtube.com/@toolweb-009) ## References - **Kong Route:** https://api.mkkpro.com/career/technical-writer - **API Docs:** https://api.mkkpro.com:8092/docs


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)