Agent Skills: OneKey Coding Patterns and Best Practices

OneKey coding patterns for TypeScript, React, promises, date formatting, and error handling.

ID: onekeyhq/app-monorepo/1k-coding-patterns

Repository

OneKeyHQLicense: NOASSERTION
2,448535

Install this agent skill to your local

npx skills add onekeyhq/app-monorepo --skill 1k-coding-patterns

Skill Files

The files that make up 1k-coding-patterns.

Download Skill

Loading file tree…

.skillshare/skills/1k-coding-patterns/SKILL.md

Skill Metadata

Name
1k-coding-patterns
Description
OneKey coding patterns for TypeScript, React, promises, date formatting, and error handling.

OneKey Coding Patterns and Best Practices

Quick Reference

TopicGuideKey Points
Promise handlingpromise-handling.mdAlways await or use void, never floating promises
React componentsreact-components.mdNamed imports, functional components, no FC type
Restricted patternsrestricted-patterns.mdForbidden: toLocaleLowerCase, direct hd-core import
Date formattingdate-formatting.mdUse OneKey dateUtils, not native date formatting
Error handlingerror-handling.mdPreserve errors across RPC/runtime boundaries

Critical Rules Summary

Promise Handling

// ❌ FORBIDDEN - floating promise
apiCall();

// ✅ CORRECT
await apiCall();
// or
void apiCall(); // intentionally not awaited

React Components

// ❌ FORBIDDEN
import React, { FC } from 'react';
const MyComponent: FC<Props> = () => {};

// ✅ CORRECT
import { useState, useCallback } from 'react';
function MyComponent({ prop }: { prop: string }) {}

Restricted Patterns

// ❌ FORBIDDEN
string.toLocaleLowerCase()
import { x } from '@onekeyfe/hd-core';
import { localDbInstance } from '...';

// ✅ CORRECT
string.toLowerCase()
const { x } = await CoreSDKLoader();
import { localDb } from '...';

Related Skills

  • /1k-i18n - Internationalization and translations
  • /1k-cross-platform - Platform-specific code
  • /1k-code-quality - Linting and code quality
  • /1k-performance - Performance optimization
  • /1k-state-management - Jotai atom patterns
  • /1k-architecture - Project structure and import rules

More agent skills